OleDbParameter.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, em bytes, 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); };[System.Data.DataSysDescription("DbDataParameter_Size")]
public int Size { get; set; }public override int Size { get; set; }[<System.Data.DataSysDescription("DbDataParameter_Size")>]
member this.Size : int with get, setmember this.Size : int with get, setPublic Property Size As IntegerPublic Overrides Property Size As IntegerValor de Propriedade
O tamanho máximo, em bytes, dos dados dentro da coluna. O valor padrão é inferido a partir do valor do parâmetro.
Implementações
- Atributos
Exemplos
O exemplo seguinte cria um OleDbParameter e define algumas das suas propriedades.
Public Sub CreateOleDbParameter()
Dim myValue As String = "12 foot scarf - multiple colors, one previous owner"
Dim parameter As New OleDbParameter("Description", OleDbType.VarChar)
parameter.Direction = ParameterDirection.Output
parameter.Size = myValue.Length
parameter.Value = myValue
End Sub 'CreateOleDbParameter
public void CreateOleDbParameter()
{
string myValue = "12 foot scarf - multiple colors, one previous owner";
OleDbParameter parameter = new OleDbParameter("Description", OleDbType.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 100 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 ValueOleDbType. Portanto, não é obrigado a especificá-las. No entanto, não são expostos em OleDbParameter ambientes imobiliários. Por exemplo, se o tamanho do parâmetro foi inferido, Size não contém o valor inferido após a execução da instrução.
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.
Se o tamanho do valor fornecido para um OleDbParameter exceder o especificado Size, o Value de contém OleDbParameter o valor especificado, truncado ao tamanho do OleDbParameter.