OleDbParameter.Size 属性

定义

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

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, set
Public Overrides Property Size As Integer
Public Property Size As Integer

属性值

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

实现

属性

示例

以下示例创建 并 OleDbParameter 设置其一些属性。

Public Sub CreateOleDbParameter()  
    Dim myValue As String = "12 foot scarf - multiple colors, one previous owner"  
    Dim parameter As New OleDbParameter("Description", OleDbType.VarChar)  
    parameter.Direction = ParameterDirection.Output  
    parameter.Size = myValue.Length  
    parameter.Value = myValue  
End Sub 'CreateOleDbParameter  
public void CreateOleDbParameter()   
 {  
    string myValue = "12 foot scarf - multiple colors, one previous owner";  
    OleDbParameter parameter = new OleDbParameter("Description", OleDbType.VarChar);  
    parameter.Direction = ParameterDirection.Output;  
    parameter.Size = myValue.Length;  
    parameter.Value = myValue;  
 }  

注解

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

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

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

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

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

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

如果为 OleDbParameter 提供的值的大小超过指定的 SizeValue 则 的 OleDbParameter 将包含指定的值,并截断为 的大小 OleDbParameter

适用于

另请参阅