DbParameter.Size Propriedade

Definição

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Origem:

DbParameter.cs

Obtém ou define o tamanho máximo, em bytes, dos dados da coluna.

public:
 abstract property int Size { int get(); void set(int value); };

public abstract int Size { get; set; }

member this.Size : int with get, set

Public MustOverride Property Size As Integer

Valor da propriedade

Int32

O tamanho máximo, em bytes, dos dados da coluna. O valor padrão é inferido do valor do parâmetro.

Implementações

Size

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 será inferido do tamanho real do parâmetro especificado quando uma instrução parametrizada for executada.

As DbType propriedades e 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 DbParameter 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 DbParameter exceder o especificado Size, o ValueDbParameter do conterá o valor especificado, truncado para o Tamanho do DbParameter.

Para parâmetros do tipo DbType.String, o valor de Size é length em caracteres Unicode. Para parâmetros do tipo DbType.Xml, Size é ignorado.

Confira também

• Visão geral do ADO.NET