如何使用 SqlParameter.Offset 属性和 ADO.NET 在 SQL Server 2012 中存储二进制文件

Question

我目前正在学习如何在不使用 SQL Server 中 varchar(max) 的 FILESTREAM 属性的情况下存储文件，因为我不需要存储非常大的二进制文件。尽管如此，我还是想按小块存储二进制数据。我发现的是 SqlParameter.Offset 属性。以下是来自 MSDN 的一些信息：

"Offset 属性用于二进制和字符串数据的客户端分块。例如，为了将 10MB 的文本插入服务器上的列中，用户可能会执行 10 次参数化的 1MB 块插入，将每次迭代的 Offset 值增加 1MB。"

听起来这正是我所需要的，但我对如何使用它感到困惑。我创建了一个非常简单的表，称为 BinaryFilesTable (Id, FileData)。Id 是主键，FileData 是 varbinary(max)。到目前为止，这是我的代码。

public static void Main(string[] args)
    {
        var fileBytes = File.ReadAllBytes("../../image.jpg");

        const string connectionString = @"Server=.; Database=TestDb; Integrated Security=true";
        SqlConnection connection = new SqlConnection(connectionString);

        connection.Open();
        using (connection)
        {
            string commandText = "INSERT INTO BinaryFilesTable(FileData) VALUES (@binaryFileData)";

            SqlCommand command = new SqlCommand(commandText, connection);

            SqlParameter commandParameter = new SqlParameter();
            commandParameter.ParameterName = "@binaryFileData";
            commandParameter.Value = fileBytes;
            commandParameter.SqlDbType = SqlDbType.VarBinary;
            commandParameter.Size = -1; // VarBinary becomes VarBinary(max) if size is set to -1.
            //commandParameter.Offset = ??? How to use it ???

            command.Parameters.Add(commandParameter);

            command.ExecuteNonQuery();
        }
    }

通过这段代码，我设法将数据存储在表中，但我不确定它是如何工作的。据我了解，在二进制数据一次存储的那一刻，这就是我想弄清楚如何使用这个 Offset 属性的原因。我花了几个小时寻找教程，但没有成功。

编辑：如果我为偏移量设置一些值，我会得到以下异常：

System.ArgumentException：偏移量和长度超出了数组的范围，或者计数大于从索引到源集合末尾的元素数。

Answer 1

Offset 属性用于二进制和字符串数据的客户端分块。

例如，为了在服务器上的一列中插入 10MB 的文本，用户可能会执行 10 次参数化的 1MB 块插入，在每次迭代中将 Offset 的值移动 1MB。

Offset 指定二进制类型的字节数和字符串的字符数。字符串计数不包括终止字符。

//Simple Use offset
parameter.Offset = 3;