DbParameter.Size Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает максимальный размер данных в байтах столбца.
public:
abstract property int Size { int get(); void set(int value); };public abstract int Size { get; set; }member this.Size : int with get, setPublic MustOverride Property Size As IntegerЗначение свойства
Максимальный размер данных в байтах в столбце. Значение по умолчанию выводится из значения параметра.
Реализации
Комментарии
Свойство Size используется для двоичных и строковых типов.
Для нестроковых типов данных и строковых данных Size ANSI свойство ссылается на количество байтов. Для строковых данных Size Юникода используется число символов. Число строк не включает конечный символ.
Для типов Size данных переменной длины описывает максимальный объем данных для передачи на сервер. Например, для строкового значения Size Юникода можно использовать для ограничения объема данных, отправляемых на сервер, на первые сотни символов.
Для двунаправленных и выходных параметров и возвращаемых значений необходимо задать значение Size. Это не обязательно для входных параметров, а если не задано явно, значение выводится из фактического размера указанного параметра при выполнении параметризованной инструкции.
Size Свойства DbType параметра можно вывести, задав параметрValue. Поэтому их не требуется указывать. Однако они не предоставляются в DbParameter параметрах свойств. Например, если размер параметра был выведен, Size не содержит выводимого значения после выполнения инструкции.
Для типов данных фиксированной Size длины значение игнорируется. Его можно получить для информационных целей и возвращать максимальное количество байтов, которые поставщик использует при передаче значения параметра серверу.
Если размер указанного значения DbParameter превышает указанное Size, ValueDbParameter значение будет содержать указанное значение, усеченное до размера DbParameter.
Для параметров типа DbType.Stringзначение Size имеет длину в символах Юникода. Для параметров типа DbType.Xml, Size игнорируется.
