Partilhar via


OleDbParameter.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; }
[System.Data.DataSysDescription("DbDataParameter_Scale")]
public byte Scale { get; set; }
member this.Scale : byte with get, set
[<System.Data.DataSysDescription("DbDataParameter_Scale")>]
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

Atributos

Exemplos

O exemplo a seguir cria um OleDbParameter e define algumas de suas propriedades.

Public Sub CreateOleDbParameter()  
    Dim parameter As New OleDbParameter("Price", OleDbType.Decimal)  
    parameter.Value = 3.1416  
    parameter.Precision = 8  
    parameter.Scale = 4  
End Sub 'CreateOleDbParameter  
public void CreateOleDbParameter()   
 {  
    OleDbParameter parameter = new OleDbParameter("Price", OleDbType.Decimal);  
    parameter.Value = 3.1416;  
    parameter.Precision = 8;  
    parameter.Scale = 4;  
 }  

Comentários

A Scale propriedade só é usada para parâmetros de entrada numéricos e decimais antes de chamar o Prepare método do OleDbCommand e para especificar parâmetros de saída numéricos.

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, truncar ou arredondar dados.

Ao usar SQL Server Native Client 10 (ou posterior), para associar um parâmetro cujo tipo é Decimal, Numeric, VarNumeric, DBDateou DBTimeStamp, você deve especificar manualmente um valor de escala apropriado.

Observação

Não há suporte para o uso dessa propriedade para forçar dados passados para o banco de dados. Para arredondar, truncar ou forçar dados antes de passá-los para o banco de dados, use a Math classe que faz parte do namespace antes de System 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 o Precision ou Scale os valores de Decimal parâmetro. Isso pode fazer com que os dados truncados sejam inseridos na fonte de dados. Se você estiver usando .NET Framework versão 1.0, valide o Precision e OleDbParameter os valores antes de Decimal definir o valor do parâmetro. Scale os valores que excedem a escala de Decimal parâmetros ainda são truncados.

Aplica-se a

Confira também