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, setPublic Overrides Property Size As IntegerPublic 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.
