DbParameter.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:
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 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
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 é exigido para parâmetros de entrada e, se não for explicitamente definido, o valor é inferido a partir do tamanho real do parâmetro especificado quando uma instrução parametrizada é executada.
As DbType propriedades e Size de um parâmetro podem ser inferidas definindo Value. Portanto, não é obrigado a especificá-las. No entanto, não são expostos em DbParameter 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.
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 DbParameter exceder o especificado Size, o Value de conterá DbParameter o valor especificado, truncado para o Tamanho do DbParameter.
Para parâmetros do tipo DbType.String, o valor de Size é comprimento em caracteres Unicode. Para parâmetros do tipo DbType.Xml, Size é ignorado.