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 값을 지정하는 것과 같이 값을 표시하지 않고 매개 변수에 대한 전체 메타데이터를 지정해야 하는 시나리오에 필요합니다.

참고

데이터베이스에 전달된 데이터를 강제 변환하는 데 이 속성을 사용하는 것은 지원되지 않습니다. 데이터를 데이터베이스에 전달하기 전에 반올림, 자르기 또는 강제 변환하려면 매개 변수의 SystemValue 속성에 값을 할당하기 전에 네임스페이스의 일부인 클래스를 사용합니다Math.

참고

.NET Framework 버전 1.0에 포함된 Microsoft .NET Framework 데이터 공급자는 매개 변수 값의 Decimal 또는 Scale 을 Precision 확인하지 않습니다. 이로 인해 잘린 데이터가 데이터 원본에 삽입될 수 있습니다. .NET Framework 버전 1.0을 사용하는 경우 매개 변수 값을 설정하기 전에 값의 Decimal 및 Scale 유효성을 검사 Precision 합니다. .NET Framework 버전 1.1 이상을 사용하는 경우 매개 변수 값이 잘못된 Precision로 설정된 경우 Decimal 예외가 throw됩니다. Scale 매개 변수 배율을 초과하는 Decimal 값은 여전히 잘립니다.