Свойство предоставляет или устанавливает максимальную длину значения параметра в байтах. Если свойство не установлено явно, то оно наследуется из значения параметра.

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

Для типов данных переменной длины свойство Size устанавливает максимальное количество данных, передаваемых на ЛИНТЕР-сервер. Например, для UTF-16 строкового значения свойство Size может быть использовано для того, чтобы ограничить объем данных, отправляемых на ЛИНТЕР-сервер, до первых ста символов.

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

Хотя значения свойства DbType и Size параметра могут быть получены из свойства Value (т.е. задавать их не обязательно), но если DbType и Size не установлены явно, то автоматически вычисляемые значения этих свойств ADO.NET-провайдером не устанавливаются. Например, если на основании свойства Value был определен размер параметра, то свойство Size не будет содержать вычисленное значение после выполнения оператора.

Для типов данных с фиксированной длиной установка значения свойства Size игнорируется. Его можно извлечь лишь в информационных целях. Свойство возвращает наибольшее количество байтов, используемых ADO.NET-провайдером при передаче значения параметра на ЛИНТЕР-сервер.

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

Для параметра типа DbType.String значение Size должно задаваться в UTF-16 символах (а не в байтах).

Длина -1 устанавливается внутри ADO.NET-провайдера и указывает на то, что параметр содержит null-значение. Клиентское приложение не должно устанавливать длину -1. Вместо этого, оно должен установить Value=null или Value=DBNull.Value.

Декларация

public abstract int Size {get; set;};

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

Объект типа int, представляющий длину параметра.

Исключения

Примеры

1) Получение свойства.

int size = parameter.Size;

2) Установка свойства.

parameter.Size = 255;