OdbcParameter.Size Propriedade

Definição

Obtém ou define o tamanho máximo 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); };
public int Size { get; set; }
public override int Size { get; set; }
member this.Size : int with get, set
Public Property Size As Integer
Public Overrides Property Size As Integer

Valor de Propriedade

O tamanho máximo dos dados dentro da coluna. O valor padrão é inferido a partir do valor do parâmetro.

Implementações

Exemplos

O exemplo seguinte cria um OdbcParameter e define algumas das suas propriedades.

Public Sub CreateOdbcParameter()
    Dim myValue As String = "12 foot scarf - multiple colors, one previous owner"
    Dim parameter As New OdbcParameter("Description", OdbcType.VarChar)
    parameter.Direction = ParameterDirection.Output
    parameter.Size = myValue.Length
    parameter.Value = myValue
End Sub
public void CreateOdbcParameter()
 {
    string myValue = "12 foot scarf - multiple colors, one previous owner";
    OdbcParameter parameter = new OdbcParameter("Description", OdbcType.VarChar);
    parameter.Direction = ParameterDirection.Output;
    parameter.Size = myValue.Length;
    parameter.Value = myValue;
 }

Observações

A Size propriedade é usada para tipos binários e de strings.

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.

Para parâmetros bidirecionais e de saída, e valores de retorno, deve definir o valor de Size. Isto não é necessário para parâmetros de entrada e, se não for explicitamente definido, o valor de é inferido a partir do tamanho real do parâmetro especificado quando uma instrução parametrizada é executada.

Os DbType, , e Size as propriedades de um parâmetro podem ser inferidos definindo ValueOdbcType. Portanto, não é obrigado a especificá-las. No entanto, não são expostos em OdbcParameter ambientes imobiliários. Por exemplo, se o tamanho do parâmetro foi inferido, Size não contém valor inferido após a execução da instrução.

Note

Para um OdbcParameter com um Direction de ParameterDirection.Output, ParameterDirection.InputOutput, ou ParameterDirection.ReturnValue, uma exceção é lançada quando o comando é executado se o tamanho do valor devolvido pela fonte de dados exceder o especificado Size do OdbcParameter.

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.

Aplica-se a

Ver também