DbParameter.Size 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置列中数据的最大大小(字节)。
public:
abstract property int Size { int get(); void set(int value); };
public abstract int Size { get; set; }
member this.Size : int with get, set
Public MustOverride Property Size As Integer
属性值
列中数据的最大大小(字节)。 默认值将根据参数值进行推断。
实现
注解
属性 Size 用于二进制和字符串类型。
对于非字符串数据类型和 ANSI 字符串数据, Size 属性引用字节数。 对于 Unicode 字符串数据, Size 是指字符数。 字符串的计数不包括终止字符。
对于可变长度数据类型, Size 描述要传输到服务器的最大数据量。 例如,对于 Unicode 字符串值, Size 可用于将发送到服务器的数据量限制为前一百个字符。
对于双向参数和输出参数以及返回值,必须设置 的值 Size。 这不是输入参数所必需的,如果未显式设置,则执行参数化语句时,将从指定参数的实际大小推断值。
DbType可以通过设置 Value来推断参数的 和 Size 属性。 因此,不需要指定它们。 但是,它们不会在属性设置中 DbParameter 公开。 例如,如果已推断参数的大小, Size 则 语句执行后不包含推断的值。
对于固定长度数据类型,将忽略 的值 Size 。 可以出于参考目的检索它,并返回提供程序在将参数的值传输到服务器时使用的最大字节量。
如果为 DbParameter 提供的值的大小超过指定的 Size, Value 则 的 DbParameter 将包含指定的值,并截断为 的大小 DbParameter。
对于 类型的DbType
String
参数, 的值Size是长度(以 Unicode 字符为单位)。 对于 类型的DbType
Xml
参数,Size将忽略 。