SqlParameter.Precision Свойство

Определение

Пространство имен:

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

Возвращает или задает максимальное количество цифр, используемых для представления свойства 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

Значение свойства

Byte

Максимальное количество цифр, используемых для представления свойства Value. Значение по умолчанию — 0. Оно указывает, что точность значения Value задает поставщик данных.

Реализации

Precision

Примеры

В следующем примере создается SqlParameter и задаются некоторые его свойства.

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

Комментарии

Свойство Precision используется параметрами, имеющими значение SqlDbTypeDecimal.

Не нужно указывать значения для Precision свойств и Scale для входных параметров, так как они могут быть выведены из значения параметра. Precision и Scale требуются для выходных параметров и для сценариев, в которых необходимо указать полные метаданные для параметра без указания значения, например указание значения NULL с определенной точностью и масштабом.

Примечание

Использование этого свойства для принудительного применения данных, передаваемых в базу данных, не поддерживается. Чтобы округить, усечь или иным образом принудить данные перед их передачей в базу данных, используйте Math класс, который является частью System пространства имен перед назначением значения свойству параметра Value .

Примечание

Поставщики данных Microsoft платформа .NET Framework, включенные в платформа .NET Framework версии 1.0, не проверяют Precision значения параметров или ScaleDecimal . Это может привести к вставке усеченных данных в источник данных. Если вы используете платформа .NET Framework версии 1.0, проверьте PrecisionScale и значенийDecimal, прежде чем задавать значение параметра. При использовании платформа .NET Framework версии 1.1 или более поздней создается исключение, если Decimal для параметра задано недопустимое Precisionзначение . Scale Значения, превышающие масштаб параметров, по-прежнему Decimal усекаются.