OleDbParameter.Size 属性

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

**命名空间:**System.Data.OleDb
**程序集:**System.Data(在 system.data.dll 中)

语法

声明
Public Overrides Property Size As Integer
用法
Dim instance As OleDbParameter
Dim value As Integer

value = instance.Size

instance.Size = value
public override int Size { get; set; }
public:
virtual property int Size {
    int get () override;
    void set (int value) override;
}
/** @property */
public int get_Size ()

/** @property */
public void set_Size (int value)
public override function get Size () : int

public override function set Size (value : int)

属性值

列中数据的最大大小(以字节为单位)。默认值是从参数值推导出的。

备注

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

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

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

对于双向参数、输出参数和返回值,必须设置 Size 的值。输入参数时对此没有要求,如果没有显式设置,则该值会在执行参数化语句时根据指定参数的实际大小推断而得。

通过设置 Value,可以推导出参数的 DbTypeOleDbTypeSize 属性。因此,无需指定它们。但是,在 OleDbParameter 属性设置中并未公开它们。例如,如果已推断出参数的大小,则语句执行后 Size 不包含推断的值。

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

如果为 OleDbParameter 提供的值的大小超过了指定的 SizeOleDbParameterValue 将包含指定的值,该值被截成了 OleDbParameter 的大小。

示例

下面的示例创建一个 OleDbParameter 并设置它的一些属性。

[Visual Basic]

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

[C#]

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;
 }

平台

Windows 98、Windows 2000 SP4、Windows Millennium Edition、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表,请参见系统要求

版本信息

.NET Framework

受以下版本支持:2.0、1.1、1.0

请参见

参考

OleDbParameter 类
OleDbParameter 成员
System.Data.OleDb 命名空间

其他资源

使用命令