OdbcParameter.Size Propriedade

Definição

Namespace:

System.Data.Odbc

Assembly:

System.Data.Odbc.dll

Pacote:

System.Data.Odbc v8.0.0

Origem:

OdbcParameterHelper.cs

Obtém ou define o tamanho máximo dos dados dentro da coluna.

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

Int32

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

Implementações

Size

Exemplos

O exemplo a seguir cria um OdbcParameter e define algumas de 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;  
 }  

Comentários

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

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 para os primeiros cem caracteres.

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

As DbTypepropriedades , OdbcTypee Size de um parâmetro podem ser inferidas definindo Value. Portanto, você não precisa especificá-los. No entanto, eles não são expostos nas OdbcParameter configurações de propriedade. Por exemplo, se o tamanho do parâmetro tiver sido inferido, Size não conterá o valor inferido após a execução da instrução.

Observação

Para um OdbcParameter com um Direction de ParameterDirection.Output, ParameterDirection.InputOutputou ParameterDirection.ReturnValue, uma exceção é gerada quando o comando é executado se o tamanho do valor retornado pela fonte de dados excede o especificado Size do OdbcParameter.

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.

Confira também

• Trabalhando com comandos