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