OdbcParameter.Scale Propriedade

Definição

Obtém ou define o número de casas decimais para as quais o 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 os quais o 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 decimal e numéricos.

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 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 scale 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

.NET Framework provedores de dados incluídos no .NET Framework versão 1.0 não verificam os scale valores de Decimal parâmetro. Isso pode fazer com que os dados modificados sejam inseridos na fonte de dados. Se você estiver usando .NET Framework versão 1.0, valide o scale de valores antes de decimal definir o valor do parâmetro. Quando você usa .NET Framework versão 1.1 ou versões posteriores, scale os valores que excedem a decimal escala de parâmetros só poderão ser truncados em escala, se esse for o comportamento do driver ODBC subjacente.

Aplica-se a

Confira também