DbParameter.Size 属性

定义

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

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

属性值

Int32

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

实现

注解

此属性 Size 用于二进制和字符串类型。

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

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

对于双向参数和输出参数以及返回值,必须设置值 Size。 这不需要输入参数,如果未显式设置,则执行参数化语句时,该值将从指定参数的实际大小推断。

DbType可以通过设置Value来推断参数的和Size属性。 因此,不需要指定它们。 但是,它们不会在属性设置中 DbParameter 公开。 例如,如果已推断参数的大小, Size 则不包含语句执行后的推断值。

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

如果为某个DbParameter值提供的值的大小超过指定Size值,ValueDbParameter则该值将包含指定值,截断为大小DbParameter

对于类型 DbType为 .String的参数,值为 Size Unicode 字符的长度。 对于类型 DbType为 .Xml的参数, Size 将忽略。

适用于

另请参阅