SqlParameter.Size Свойство

  • Ссылка

Определение

Пространство имен:
System.Data.SqlClient
Сборка:
System.Data.SqlClient.dll
Сборка:
System.Data.dll
Пакет:
System.Data.SqlClient v4.8.6

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

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, set
Public Overrides Property Size As Integer
Public Property Size As Integer

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

Int32

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

Реализации

Size
Атрибуты
DataSysDescriptionAttribute

Примеры

В следующем примере создается 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.

Применяется к

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