SqlParameter.Size Свойство

Определение

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

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

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

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

public override int Size { get; set; }

member this.Size : int with get, set

Public Overrides Property Size As Integer

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

Int32

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

Реализации

Size

Примеры

В следующем примере создается SqlParameter и задаются некоторые его свойства.

// using Microsoft.Data.SqlClient;
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;
}

Комментарии

Это свойство не влияет на возвращаемые значения; Возвращаемые параметры из хранимых процедур всегда являются целыми числами фиксированного размера.

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

Свойство Size используется для двоичных и строковых типов. Для параметров типа SqlType.Stringозначает Size длину в символах Юникода. Для параметров типа SqlType.Xmlигнорируется Size .

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

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

Если значение не задано явным образом, размер определяется на основе фактического размера указанного значения параметра.

Если дробная часть значения параметра больше размера, значение будет усечено в соответствии с размером.

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

Сведения о потоковой передаче см. в разделе Поддержка потоковой передачи SqlClient.