SqlParameter.Size 属性

定义

命名空间:

Microsoft.Data.SqlClient

程序集:

Microsoft.Data.SqlClient.dll

包:

Microsoft.Data.SqlClient v5.2.0

获取或设置列中数据的最大大小（字节）。

public:
 virtual property int Size { int get(); void set(int value); };

public override int Size { get; set; }

member this.Size : int with get, set

Public Overrides Property Size As Integer

属性值

Int32

列中数据的最大大小（字节）。 默认值将根据参数值进行推断。

实现

Size

示例

以下示例创建 并 SqlParameter 设置其一些属性。

// using Microsoft.Data.SqlClient;
static void CreateSqlParameterSize()
{
    string description = "12 foot scarf - multiple colors, one previous owner";
    SqlParameter parameter = new SqlParameter("Description", SqlDbType.VarChar);
    parameter.Direction = ParameterDirection.InputOutput;
    parameter.Size = description.Length;
    parameter.Value = description;
}

注解

返回值不受此属性影响;存储过程的返回参数始终是固定大小的整数。

对于长度类型 (nvarchar 的输出参数（例如) ），参数的大小定义包含输出参数的缓冲区的大小。 输出参数可以截断为使用 Size指定的大小。 对于字符类型，使用 Size 指定的大小以字符为单位。

属性 Size 用于二进制和字符串类型。 对于 类型的 SqlType.String参数， Size 表示长度（以 Unicode 字符为单位）。 对于 类型的 SqlType.Xml参数， Size 将被忽略。

对于非字符串数据类型和 ANSI 字符串数据， Size 属性引用字节数。 对于 Unicode 字符串数据， Size 是指字符数。 字符串计数不包括终止字符。

对于可变长度数据类型， Size 描述要传输到服务器的最大数据量。 例如，对于 Unicode 字符串值， Size 可用于将发送到服务器的数据量限制为前一百个字符。

如果未显式设置，则从指定参数值的实际大小推断大小。

如果参数值的小数部分大于大小，则会截断该值以匹配大小。

对于固定长度数据类型，将忽略 的值 Size 。 可以检索该参数以供参考，并返回提供程序在将参数值传输到服务器时使用的最大字节数。

有关流式处理的信息，请参阅 SqlClient 流式处理支持。