SqlParameter.Precision Propriedade

Definição

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.

Aplica-se a

Ver também