SqlParameter.Precision Właściwość

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

Pobiera lub ustawia maksymalną liczbę cyfr używanych do reprezentowania Value właściwości.

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

Wartość właściwości

Byte

Maksymalna liczba cyfr używanych do reprezentowania Value właściwości. Wartość domyślna to 0. Oznacza to, że dostawca danych określa dokładność dla parametru Value.

Implementuje

Precision

Przykłady

Poniższy przykład tworzy obiekt SqlParameter i ustawia niektóre z jego właściwości.

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

Uwagi

Właściwość Precision jest używana przez parametry, które mają SqlDbType wartość .Decimal

Nie trzeba określać wartości parametrów Precision wejściowych i , Scale ponieważ można je wywnioskować z wartości parametru . Precision i Scale są wymagane dla parametrów wyjściowych i dla scenariuszy, w których należy określić pełne metadane dla parametru bez wskazywania wartości, takich jak określanie wartości null z określoną dokładnością i skalowaniem.

Uwaga

Użycie tej właściwości do przetwarzania danych przekazywanych do bazy danych nie jest obsługiwane. Aby zaokrąglić, obcinać lub w inny sposób przekształcać dane przed przekazaniem ich do bazy danych, użyj Math klasy, która jest częścią System przestrzeni nazw przed przypisaniem wartości do właściwości parametru Value .

Uwaga

Dostawcy danych microsoft .NET Framework dołączone do .NET Framework w wersji 1.0 nie weryfikują Precision wartości parametrów Decimal ani Scale . Może to spowodować obcięcie danych w źródle danych. Jeśli używasz .NET Framework w wersji 1.0, przed ustawieniem wartości parametru zweryfikuj PrecisionDecimal wartości i Scale . Jeśli używasz .NET Framework w wersji 1.1 lub nowszej, zgłaszany jest wyjątek, jeśli Decimal wartość parametru jest ustawiona z nieprawidłowym Precisionelementem . Scale wartości przekraczające skalę parametrów Decimal są nadal obcinane.