SqlParameter.Size Propriedade

  • Referência

Definição

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Pacote:
System.Data.SqlClient v4.8.6

Obtém ou define o tamanho máximo, em bytes, dos dados da coluna.

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

Valor da propriedade

Int32

O tamanho máximo, em bytes, dos dados da coluna. O valor padrão é inferido do valor do parâmetro.

Implementações

Size
Atributos
DataSysDescriptionAttribute

Exemplos

O exemplo a seguir cria um SqlParameter e define algumas de suas propriedades.

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

Comentários

Os valores retornados não são afetados por essa propriedade; parâmetros de retorno de procedimentos armazenados são sempre inteiros de tamanho fixo.

Para parâmetros de saída com um tipo de comprimento variável (nvarchar, por exemplo), o tamanho do parâmetro define o tamanho do buffer que contém o parâmetro de saída. O parâmetro de saída pode ser truncado para um tamanho especificado com Size. Para tipos de caracteres, o tamanho especificado com Size está em caracteres.

A Size propriedade é usada para tipos binários e de cadeia de caracteres. Para parâmetros do tipo SqlType.String, Size significa comprimento em caracteres Unicode. Para parâmetros do tipo SqlType.Xml, Size é ignorado.

Para tipos de dados nãostring e dados de cadeia de caracteres ANSI, a Size propriedade refere-se ao número de bytes. Para dados de cadeia de caracteres Unicode, Size refere-se ao número de caracteres. A contagem de cadeias de caracteres não inclui o caractere de terminação.

Para tipos de dados de comprimento variável, Size descreve a quantidade máxima de dados a serem transmitidos para o servidor. Por exemplo, para um valor de cadeia de caracteres Unicode, Size pode ser usado para limitar a quantidade de dados enviados ao servidor aos primeiros cem caracteres.

Se não for definido explicitamente, o tamanho será inferido do tamanho real do valor do parâmetro especificado.

Se a parte fracionária do valor do parâmetro for maior que o tamanho, o valor será truncado para corresponder ao tamanho.

Para tipos de dados de comprimento fixo, o valor de Size é ignorado. Ele pode ser recuperado para fins informativos e retorna a quantidade máxima de bytes que o provedor usa ao transmitir o valor do parâmetro para o servidor.

Para obter informações sobre streaming, consulte Suporte de streaming do SqlClient.

Aplica-se a

Confira também