SqlParameter.Size Propriedade

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

Valor da propriedade

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

Implementações

Exemplos

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

// 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;
}

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