Поделиться через


OdbcParameter.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; }
public int Size { get; set; }
member this.Size : int with get, set
Public Overrides Property Size As Integer
Public Property Size As Integer

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

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

Реализации

Примеры

В следующем примере создается OdbcParameter и задаются некоторые его свойства.

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

Комментарии

Свойство Size используется для двоичных и строковых типов.

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

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

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

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

Примечание

OdbcParameter Для объекта с ParameterDirection.OutputDirection , ParameterDirection.InputOutputили ParameterDirection.ReturnValueисключение возникает при выполнении команды, если размер значения, возвращаемого источником данных, превышает указанное SizeOdbcParameterзначение .

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

Применяется к

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