OracleParameter.Size Propriedade

Definição

Namespace:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

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 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, em bytes, dos dados da coluna. O valor padrão é 0 (para ser usado quando você não quiser especificar o tamanho máximo do valor).

Implementações

Size

Exemplos

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

Public Sub CreateOracleParameter()  
   Dim parameter As New OracleParameter("pDescription", OracleType.VarChar)  
   parameter.IsNullable = True  
   parameter.Direction = ParameterDirection.Output  
   parameter.Size = 88  
End Sub  

public void CreateOracleParameter()   
{  
   OracleParameter parameter = new OracleParameter("pDescription", OracleType.VarChar);  
   parameter.IsNullable = true;  
   parameter.Direction = ParameterDirection.Output;  
   parameter.Size = 88;  
}  

Comentários

A configuração Size afeta apenas o valor de entrada de um parâmetro. Os valores retornados e os parâmetros de saída não são afetados por essa propriedade.

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 , OracleTypee 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 OracleParameter 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.

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.