OleDbParameter.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, em bytes, dos dados 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; }[System.Data.DataSysDescription("DbDataParameter_Size")]
public int Size { get; set; }member this.Size : int with get, set[<System.Data.DataSysDescription("DbDataParameter_Size")>]
member this.Size : int with get, setPublic Overrides Property Size As IntegerPublic Property Size As IntegerValor da propriedade
O tamanho máximo, em bytes, dos dados da coluna. O valor padrão é inferido do valor do parâmetro.
Implementações
- Atributos
Exemplos
O exemplo a seguir cria um OleDbParameter e define algumas de 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;
}
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 aos primeiros 100 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 , OleDbTypee Size de um parâmetro podem ser inferidas definindo Value. Portanto, você não precisa especificá-las. No entanto, eles não são expostos nas OleDbParameter 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.
Se o tamanho do valor fornecido para um OleDbParameter exceder o especificado Size, o ValueOleDbParameter do conterá o valor especificado, truncado para o tamanho do OleDbParameter.
