SqlParameter.Size Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o tamanho máximo, em bytes, dos dados dentro da coluna.
public:
property int Size { int get(); void set(int value); };public:
virtual property int Size { int get(); void set(int value); };[System.Data.DataSysDescription("DbDataParameter_Size")]
public int Size { get; set; }public override int Size { get; set; }[<System.Data.DataSysDescription("DbDataParameter_Size")>]
member this.Size : int with get, setmember this.Size : int with get, setPublic Property Size As IntegerPublic Overrides Property Size As IntegerValor de Propriedade
O tamanho máximo, em bytes, dos dados dentro da coluna. O valor padrão é inferido a partir do valor do parâmetro.
Implementações
- Atributos
Exemplos
O exemplo seguinte cria um SqlParameter e define algumas das 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
Observações
Os valores de retorno não são afetados por esta propriedade; os parâmetros de retorno dos 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 é em caracteres.
A Size propriedade é usada para tipos binários e de strings. Para parâmetros do tipo SqlType.String, Size a média do comprimento em caracteres Unicode. Para parâmetros do tipo SqlType.Xml, Size é ignorado.
Para tipos de dados não-string e dados de strings ANSI, a Size propriedade refere-se ao número de bytes. Para dados de cadeia Unicode, Size refere-se ao número de caracteres. A contagem de cadeias não inclui o carácter terminante.
Para tipos de dados de comprimento variável, Size descreve a quantidade máxima de dados a transmitir para o servidor. Por exemplo, para um valor de cadeia Unicode, Size poderia ser usado para limitar a quantidade de dados enviados ao servidor aos primeiros cem caracteres.
Se não for explicitamente definido, o tamanho é inferido a partir do tamanho real do valor do parâmetro especificado.
Se a parte fracionária do valor do parâmetro for maior que o tamanho, então o valor será truncado para corresponder ao tamanho.
Para tipos de dados de comprimento fixo, o valor de Size é ignorado. Pode ser recuperado para fins informativos e devolve o número máximo de bytes que o fornecedor utiliza ao transmitir o valor do parâmetro ao servidor.
Para informações sobre streaming, consulte SqlClient Streaming Support.