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