Бөлісу құралы:

SqlParameter.Size Свойство

Определение

Пространство имен:
System.Data.SqlClient
Сборка:
System.Data.SqlClient.dll
Сборка:
System.Data.dll
Исходный код:
System.Data.SqlClient.notsupported.cs

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

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.XmlSize игнорируется.

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

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

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

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

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

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

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

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