OdbcParameter.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; }
public int Size { get; set; }
member this.Size : int with get, set
Public Overrides Property Size As Integer
Public Property Size As Integer
属性值
列内数据的最大大小。 默认值将根据参数值进行推断。
实现
示例
以下示例创建 并 OdbcParameter 设置其一些属性。
Public Sub CreateOdbcParameter()
Dim myValue As String = "12 foot scarf - multiple colors, one previous owner"
Dim parameter As New OdbcParameter("Description", OdbcType.VarChar)
parameter.Direction = ParameterDirection.Output
parameter.Size = myValue.Length
parameter.Value = myValue
End Sub
public void CreateOdbcParameter()
{
string myValue = "12 foot scarf - multiple colors, one previous owner";
OdbcParameter parameter = new OdbcParameter("Description", OdbcType.VarChar);
parameter.Direction = ParameterDirection.Output;
parameter.Size = myValue.Length;
parameter.Value = myValue;
}
注解
属性 Size 用于二进制和字符串类型。
对于非字符串数据类型和 ANSI 字符串数据, Size 属性引用字节数。 对于 Unicode 字符串数据, Size 是指字符数。 字符串的计数不包括终止字符。
对于可变长度数据类型, Size
描述要传输到服务器的最大数据量。 例如,对于 Unicode 字符串值, Size
可用于将发送到服务器的数据量限制为前一百个字符。
对于双向参数和输出参数以及返回值,必须设置 的值 Size
。 输入参数不需要这样做,如果未显式设置,在执行参数化语句时,将从指定参数的实际大小推断 的值。
DbType可以通过设置 Value来推断参数的 、 OdbcType和 Size 属性。 因此,不需要指定它们。 但是,它们不会在属性设置中 OdbcParameter 公开。 例如,如果已推断参数的大小, Size
则 语句执行后不包含推断的值。
注意
OdbcParameter
对于为 Direction 、 ParameterDirection.InputOutput
或 ParameterDirection.ReturnValue
的 ParameterDirection.Output
,如果数据源返回的值的大小超过 Size
OdbcParameter指定的 ,则在执行命令时将引发异常。
对于固定长度数据类型,将忽略 的值 Size
。 可以出于参考目的检索它,并返回提供程序在将参数的值传输到服务器时使用的最大字节量。