SqlParameter.Precision Propriedade

Definição

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v5.2.0

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.

using Microsoft.Data.SqlClient;

class Program
{
    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);
    }
}

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 forçar dados passados para o banco de dados. Para arredondar, truncar ou forçar 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 o Precision ou Scale os valores de 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 é definido com um inválidoPrecision. Scale os valores que excedem a escala de Decimal parâmetros ainda são truncados.