OleDbParameter.Scale Propriedade

Definição

Espaço de Nomes:
System.Data.OleDb
Assemblagem:
System.Data.dll

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

Valor de Propriedade

Byte

O número de casas decimais para os quais Value é resolvido. A predefinição é 0.

Implementações

Scale
Atributos
DataSysDescriptionAttribute

Exemplos

O exemplo seguinte cria um OleDbParameter e define algumas das 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;
 }

Observações

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

Definir esta propriedade para um valor diferente do valor na base de dados depende da implementação do fornecedor de dados e pode devolver um código de erro, truncate ou dados de ronda.

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

Note

A utilização desta propriedade para coagir dados passados para a base de dados não é suportada. Para arredondar, truncar ou de outra forma coagir dados antes de os passar para a base de dados, use a Math classe que faz parte do System namespace antes de atribuir um valor à propriedade do Value parâmetro.

Note

.NET fornecedores de dados do Framework incluídos na versão 1.0 do .NET Framework não verificam o Precision ou Scale dos valores do parâmetro Decimal. Isto pode fazer com que dados truncados sejam inseridos na fonte de dados. Se estiver a usar .NET Framework versão 1.0, valide o Precision e OleDbParameter dos valores Decimal antes de definir o valor do parâmetro. Scale valores que excedem a Decimal escala de parâmetros continuam truncados.

Aplica-se a

Ver também