Size
Свойство предоставляет или устанавливает максимальную длину значения параметра в байтах. Если свойство не установлено явно, то оно наследуется из значения параметра.
Свойство Size используется для числовых и строковых типов данных.
Для типов данных переменной длины свойство Size устанавливает максимальное количество данных, передаваемых на ЛИНТЕР-сервер. Например, для UTF-16 строкового значения свойство Size может быть использовано для того, чтобы ограничить объем данных, отправляемых на ЛИНТЕР-сервер, до первых ста символов.
Примечание
Для всех параметров переменной длины необходимо явно установить ненулевое значение 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 символах (а не в байтах).
Примечание
В текущей версии ADO.NET-провайдера значение Size всегда должно задаваться в байтах.
Длина -1 устанавливается внутри ADO.NET-провайдера и указывает на то, что параметр содержит null-значение. Клиентское приложение не должно устанавливать длину -1. Вместо этого, оно должен установить Value=null или Value=DBNull.Value.
Декларация
public abstract int Size {get; set;};
Значение свойства
Объект типа int, представляющий длину параметра.
Исключения
ArgumentException
| Недопустимая длина параметра. |
Примеры
1) Получение свойства.
int size = parameter.Size;
2) Установка свойства.
parameter.Size = 255;