DbParameter.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:
abstract property int Size { int get(); void set(int value); };public abstract int Size { get; set; }member this.Size : int with get, setPublic MustOverride 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
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.
