OdbcParameter.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 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.