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