SqlParameter.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; }[System.Data.DataSysDescription("DbDataParameter_Size")]
public int Size { get; set; }member this.Size : int with get, set[<System.Data.DataSysDescription("DbDataParameter_Size")>]
member this.Size : int with get, setPublic Overrides Property Size As IntegerPublic Property Size As IntegerЗначение свойства
Максимальный размер в байтах данных внутри столбца. Значение по умолчанию определяется исходя из значения параметра.
Реализации
- Атрибуты
Примеры
В следующем примере создается SqlParameter и задаются некоторые его свойства.
static void CreateSqlParameterSize()
{
string description = "12 foot scarf - multiple colors, one previous owner";
SqlParameter parameter = new SqlParameter("Description", SqlDbType.VarChar);
parameter.Direction = ParameterDirection.InputOutput;
parameter.Size = description.Length;
parameter.Value = description;
}
Private Sub CreateSqlParameterSize()
Dim description As String = "12 foot scarf - multiple colors, one previous owner"
Dim parameter As New SqlParameter("Description", SqlDbType.VarChar)
parameter.Direction = ParameterDirection.InputOutput
parameter.Size = description.Length
parameter.Value = description
End Sub
Комментарии
Это свойство не влияет на возвращаемые значения; Возвращаемые параметры из хранимых процедур всегда являются целыми числами фиксированного размера.
Для выходных параметров с типом переменной длины (например, nvarchar) размер параметра определяет размер буфера, вмедущего выходной параметр. Выходной параметр можно усекать до размера, указанного с помощью Size. Для типов символов размер, указанный параметром Size , содержится в символах.
Свойство Size используется для двоичных и строковых типов. Для параметров типа SqlType.Stringозначает Size длину в символах Юникода. Для параметров типа SqlType.Xmlигнорируется Size .
Для нестроковых типов данных и строковых данных Size ANSI свойство ссылается на количество байтов. Для строковых данных Size в Юникоде обозначает количество символов. Число строк не включает символ конца.
Для типов данных переменной длины описывает максимальный объем данных, Size передаваемых на сервер. Например, для строкового значения Юникода можно использовать, чтобы ограничить объем данных, Size отправляемых на сервер, до первых сотен символов.
Если значение не задано явным образом, размер выводится на основе фактического размера указанного значения параметра.
Если дробная часть значения параметра больше размера, значение будет усечено в соответствии с размером.
Для типов данных фиксированной Size длины значение игнорируется. Его можно получить в информационных целях и вернуть максимальное количество байтов, используемое поставщиком при передаче значения параметра на сервер.
Сведения о потоковой передаче см. в разделе Поддержка потоковой передачи SqlClient.
