OdbcParameter.Size Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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:
property int Size { int get(); void set(int value); };public override int Size { get; set; }public int Size { get; set; }member this.Size : int with get, setPublic Overrides Property Size As IntegerPublic Property Size As IntegerValor da propriedade
O tamanho máximo dos dados dentro da coluna. O valor padrão é inferido do valor do parâmetro.
Implementações
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.
