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 。 可以出于信息性目的检索它,并返回提供程序在将参数值传输到服务器时使用的最大字节数。
如果为指定的
对于类型 DbType为 .String的参数,值为 Size Unicode 字符的长度。 对于类型 DbType为 .Xml的参数, Size 将忽略。