DbParameter.Size Свойство

Определение

Пространство имен:

System.Data.Common

Сборка:

System.Data.Common.dll

Исходный код:

DbParameter.cs

Возвращает или задает максимальный размер (в байтах) данных внутри столбца.

public:
 abstract property int Size { int get(); void set(int value); };

public abstract int Size { get; set; }

member this.Size : int with get, set

Public MustOverride Property Size As Integer

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

Int32

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

Реализации

Size

Комментарии

Свойство Size используется для двоичных и строковых типов.

Для нестроковых типов данных и строковых данных Size ANSI свойство ссылается на количество байтов. Для строковых данных Size в Юникоде обозначает количество символов. Число строк не включает символ конца.

Для типов данных переменной длины описывает максимальный объем данных, Size передаваемых на сервер. Например, для строкового значения Юникода можно использовать, чтобы ограничить объем данных, Size отправляемых на сервер, до первых сотен символов.

Для двунаправленных и выходных параметров, а также возвращаемых значений необходимо задать значение Size. Это не требуется для входных параметров, и если значение не задано явным образом, значение выводится из фактического размера указанного параметра при выполнении параметризованной инструкции.

Свойства DbType и Size параметра можно вывести, задав .Value Поэтому указывать их не требуется. Однако они не предоставляются в DbParameter параметрах свойств. Например, если размер параметра был выведен, Size не содержит выводимых значений после выполнения инструкции.

Для типов данных фиксированной Size длины значение игнорируется. Его можно получить в информационных целях и вернуть максимальное количество байтов, используемое поставщиком при передаче значения параметра на сервер.

Если размер значения, указанного для , DbParameter превышает указанный Size, ValueDbParameter объект объекта будет содержать указанное значение, усеченное до размера DbParameter.

Для параметров типа DbType.Stringзначение Size равно length в символах Юникода. Для параметров типа DbType.Xml, Size игнорируется.

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

• Общие сведения об ADO.NET