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,可以推导出参数的 DbType、OleDbType 和 Size 属性。因此,无需指定它们。但是,在 OleDbParameter 属性设置中并未公开它们。例如,如果已推断出参数的大小,则语句执行后 Size 不包含推断的值。
对于固定长度数据类型,忽略 Size 的值。它可以被检索来提供信息,并返回在向服务器传输参数值时提供程序所使用的最大字节数。
如果为 OleDbParameter 提供的值的大小超过了指定的 Size,OleDbParameter 的 Value 将包含指定的值,该值被截成了 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 命名空间