SqlParameter.Size 属性

  • 参考

定义

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

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

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 流式处理支持。

适用于

另请参阅