SqlParameter.Precision Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o número máximo de dígitos usados para representar a Value propriedade.
public:
property System::Byte Precision { System::Byte get(); void set(System::Byte value); };
[System.Data.DataSysDescription("DbDataParameter_Precision")]
public byte Precision { get; set; }
public byte Precision { get; set; }
[<System.Data.DataSysDescription("DbDataParameter_Precision")>]
member this.Precision : byte with get, set
member this.Precision : byte with get, set
Public Property Precision As Byte
Valor de Propriedade
O número máximo de dígitos usados para representar a Value propriedade. O valor padrão é 0. Isto indica que o fornecedor de dados define a precisão para Value.
Implementações
- Atributos
Exemplos
O exemplo seguinte cria um SqlParameter e define algumas das suas propriedades.
private static void AddSqlParameter(SqlCommand command)
{
SqlParameter parameter = new SqlParameter("@Price", SqlDbType.Decimal);
parameter.Value = 3.1416;
parameter.Precision = 8;
parameter.Scale = 4;
command.Parameters.Add(parameter);
}
Private Sub AddSqlParameter(ByVal command As SqlCommand)
Dim parameter As New SqlParameter("@Price", SqlDbType.Decimal)
With parameter
.Value = 3.1416
.Precision = 8
.Scale = 4
End With
command.Parameters.Add(parameter)
End Sub
Observações
A Precision propriedade é usada por parâmetros que têm um SqlDbType de Decimal.
Não é necessário especificar valores para as Precision propriedades e Scale dos parâmetros de entrada, pois podem ser inferidos a partir do valor do parâmetro.
Precision e Scale são necessárias para parâmetros de saída e para cenários onde é necessário especificar metadados completos para um parâmetro sem indicar um valor, como especificar um valor nulo com precisão e escala específicas.
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
Microsoft .NET os 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 causar a inserção de dados truncados na fonte de dados. Se estiver a usar .NET Framework versão 1.0, valide o Precision e Scale dos valores Decimal antes de definir o valor do parâmetro. Quando usa .NET Framework versão 1.1 ou uma versão posterior, é lançada uma exceção se um valor de parâmetro Decimal for definido com um Precision inválido. Scale valores que excedem a Decimal escala de parâmetros continuam truncados.