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


OleDbParameter.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; }
[System.Data.DataSysDescription("DbDataParameter_Size")]
public int Size { get; set; }
member this.Size : int with get, set
[<System.Data.DataSysDescription("DbDataParameter_Size")>]
member this.Size : int with get, set
Public Overrides Property Size As Integer
Public Property Size As Integer

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

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

Реализации

Атрибуты

Примеры

В следующем примере создается 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.

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

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