OdbcParameter.Scale 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 número de casas decimais para as quais Value é resolvido.
public:
property System::Byte Scale { System::Byte get(); void set(System::Byte value); };
public byte Scale { get; set; }
member this.Scale : byte with get, set
Public Property Scale As Byte
Valor da propriedade
O número de casas decimais para as quais Value é resolvido. O padrão é 0.
Implementações
Exemplos
O exemplo a seguir cria um OdbcParameter e define algumas de suas propriedades.
Public Sub CreateOdbcParameter()
Dim parameter As New OdbcParameter("Price", OdbcType.Decimal)
parameter.Value = 3.1416
parameter.Precision = 8
parameter.Scale = 4
End Sub
public void CreateOdbcParameter()
{
OdbcParameter parameter = new OdbcParameter("Price", OdbcType.Decimal);
parameter.Value = 3.1416;
parameter.Precision = 8;
parameter.Scale = 4;
}
Comentários
A Scale propriedade é usada apenas para parâmetros de entrada numéricos e decimais.
O efeito de definir essa propriedade como um valor diferente do valor no banco de dados depende da implementação do provedor de dados e pode retornar um código de erro ou truncar ou arredondar dados.
A Scale propriedade afeta apenas parâmetros cujo OdbcType é Decimal ou Numeric. Para outros tipos de dados, Scale é ignorado.
Ao usar o SQL Server Native Client 10 (ou posterior) para associar um parâmetro cujo tipo é Decimal, Numeric, VarNumeric, DBDate ou DBTimeStamp, você deve especificar manualmente um valor de escala apropriado.
Observação
Não há suporte para o uso dessa propriedade para coagir dados passados para o banco de dados. Para arredondar, truncar ou coagir dados antes de passá-los para o banco de dados, use a Math classe que faz parte do System namespace antes de atribuir um valor à propriedade do Value parâmetro.
Observação
Os provedores de dados do .NET Framework incluídos no .NET Framework versão 1.0 não verificam os scale valores de Decimal parâmetro. Isso pode causar a inserção de dados modificados na fonte de dados. Se você estiver usando o .NET Framework versão 1.0, valide os scale valores antes de decimal definir o valor do parâmetro. Quando você usa o .NET Framework versão 1.1 ou versões posteriores, scale os valores que excedem a escala de decimal parâmetros só poderão ser truncados em escala, se esse for o comportamento do driver ODBC subjacente.