OleDbParameter.Size Свойство

Определение

Пространство имен:

System.Data.OleDb

Сборка:

System.Data.OleDb.dll

Пакет:

System.Data.OleDb v8.0.0

Исходный код:

DbParameterHelper.cs

Возвращает или задает максимальный размер (в байтах) данных внутри столбца.

public:
 virtual property int Size { int get(); void set(int value); };

public override int Size { get; set; }

member this.Size : int with get, set

Public Overrides Property Size As Integer

Значение свойства

Int32

Максимальный размер в байтах данных внутри столбца. Значение по умолчанию определяется исходя из значения параметра.

Реализации

Size

Примеры

В следующем примере создается 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 используется для двоичных и строковых типов.

Для нестроковых типов данных и строковых данных Size ANSI свойство ссылается на количество байтов. Для строковых данных Size Юникода обозначает количество символов. Число строк не включает завершающий символ.

Для типов данных переменной длины описывает максимальный объем данных, Size передаваемых на сервер. Например, для строкового значения Юникода можно использовать, чтобы ограничить объем данных, Size отправляемых на сервер, до первых 100 символов.

Для двунаправленных и выходных параметров, а также возвращаемых значений Sizeнеобходимо задать значение . Это не требуется для входных параметров, и если значение не задано явным образом, значение выводится из фактического размера указанного параметра при выполнении параметризованной инструкции.

Свойства DbType, OleDbTypeи Size параметра можно вывести, задав .Value Поэтому указывать их не требуется. Однако они не предоставляются в OleDbParameter параметрах свойств. Например, если был выведен размер параметра, Size не содержит выводимых значений после выполнения инструкции.

Для типов данных фиксированной Size длины значение игнорируется. Его можно получить в информационных целях и вернуть максимальное количество байтов, используемое поставщиком при передаче значения параметра на сервер.

Если размер значения, предоставленного для , OleDbParameter превышает указанный Size, ValueOleDbParameter объект объекта содержит указанное значение, усеченное до размера OleDbParameter.

См. также раздел

• Работа с командами