SqlParameter.Precision Propriedade

Definição

Obtém ou define o número máximo de dígitos usados para representar a propriedade Value.

public:
 property System::Byte Precision { System::Byte get(); void set(System::Byte value); };
public byte Precision { get; set; }
[System.Data.DataSysDescription("DbDataParameter_Precision")]
public byte Precision { get; set; }
member this.Precision : byte with get, set
[<System.Data.DataSysDescription("DbDataParameter_Precision")>]
member this.Precision : byte with get, set
Public Property Precision As Byte

Valor da propriedade

Byte

O número máximo de dígitos usados para representar a propriedade Value. O valor padrão é 0. Isso indica que o provedor dedados define a precisão para Value.

Implementações

Atributos

Exemplos

O exemplo a seguir cria um SqlParameter e define algumas de 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

Comentários

A Precision propriedade é usada por parâmetros que têm um SqlDbType de Decimal.

Você não precisa especificar valores para os Precision parâmetros de entrada e Scale propriedades, pois eles podem ser inferidos do valor do parâmetro. Precision e Scale são necessários para parâmetros de saída e para cenários em que você precisa especificar metadados completos para um parâmetro sem indicar um valor, como especificar um valor nulo com uma precisão e uma escala específicas.

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 namespace antes de System atribuir um valor à propriedade do Value parâmetro.

Observação

Os provedores de dados do Microsoft .NET Framework incluídos no .NET Framework versão 1.0 não verificam os Precision valores de parâmetro ou de Scale Decimal parâmetro. Isso pode causar a inserção de dados truncados na fonte de dados. Se você estiver usando .NET Framework versão 1.0, valide o Precision e Scale os valores antes de Decimal definir o valor do parâmetro. Quando você usa .NET Framework versão 1.1 ou uma versão posterior, uma exceção é gerada se um Decimal valor de parâmetro for definido com um valor inválidoPrecision. Scale os valores que excedem a escala de Decimal parâmetro ainda são truncados.

Aplica-se a

Confira também