SqlParameter.Size 属性

  • 参考

定义

命名空间:
System.Data.SqlClient
程序集:
System.Data.SqlClient.dll
程序集:
System.Data.dll

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

public:
 virtual property int Size { int get(); void set(int value); };
public:
 property int Size { int get(); void set(int value); };
public override int Size { get; set; }
[System.Data.DataSysDescription("DbDataParameter_Size")]
public int Size { get; set; }
member this.Size : int with get, set
[<System.Data.DataSysDescription("DbDataParameter_Size")>]
member this.Size : int with get, set
Public Overrides Property Size As Integer
Public Property Size As Integer

属性值

Int32

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

实现

Size
属性
DataSysDescriptionAttribute

示例

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

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;
}

Private Sub CreateSqlParameterSize()
    Dim description As String = "12 foot scarf - multiple colors, one previous owner"
    Dim parameter As New SqlParameter("Description", SqlDbType.VarChar)
    parameter.Direction = ParameterDirection.InputOutput
    parameter.Size = description.Length
    parameter.Value = description
End Sub

注解

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

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

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

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

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

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

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

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

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

适用于

另请参阅