OleDbParameter.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 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
, DBDate
ou 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.