SqlParameter.Precision Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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, setPublic Property Precision As ByteValor da propriedade
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
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.