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 длины значение игнорируется. Его можно получить в информационных целях и вернуть максимальное количество байтов, используемое поставщиком при передаче значения параметра на сервер.

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

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

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