SqlParameter.Size 属性
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取或设置列中数据的最大大小（以字节为单位）。
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, setPublic Overrides Property Size As IntegerPublic Property Size As Integer属性值
列中数据的最大大小（以字节为单位）。 从参数值推断默认值。
实现
- 属性
示例
以下示例创建 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 流式处理支持。
