SqlParameter.Precision Propriedade

Definição

Namespace:

System.Data.SqlClient

Assembly:

System.Data.SqlClient.dll

Pacote:

System.Data.SqlClient v4.8.6

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; }

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

Precision

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 as Precision propriedades e Scale para parâmetros de entrada, 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 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 System namespace antes de 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 Decimal parâmetro ou Scale . 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 inválidoPrecision. Scale os valores que excedem a escala de Decimal parâmetros ainda são truncados.

Confira também

• Comandos e parâmetros
• Parâmetros DataAdapter
• SQL Server e ADO.NET
• Visão geral do ADO.NET