SqlParameter.Scale Vlastnost

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

Získá nebo nastaví počet desetinných míst, na které Value se přeloží.

public:
 property System::Byte Scale { System::Byte get(); void set(System::Byte value); };

public byte Scale { get; set; }

member this.Scale : byte with get, set

Public Property Scale As Byte

Hodnota vlastnosti

Byte

Počet desetinných míst, na který Value se přeloží. Výchozí hodnota je 0.

Implementuje

Scale

Příklady

Následující příklad vytvoří SqlParameter a nastaví některé jeho vlastnosti.

// using Microsoft.Data.SqlClient;
static void CreateSqlParameterPrecisionScale()
{
    SqlParameter parameter = new SqlParameter("Price", SqlDbType.Decimal);
    parameter.Value = 3.1416;
    parameter.Precision = 8;
    parameter.Scale = 4;
}

Poznámky

Vlastnost Scale je používána parametry, které mají hodnotu SqlDbTypeDecimal.

Upozornění

Data mohou být zkrácena, pokud Scale vlastnost není explicitně zadána a data na serveru se nehodí do měřítka 0 (výchozí).

Není nutné zadávat hodnoty vlastností Precision a Scale vstupních parametrů, protože je možné je odvodit z hodnoty parametru. Precision a Scale jsou vyžadovány pro výstupní parametry a pro scénáře, kdy potřebujete zadat úplná metadata parametru bez uvedení hodnoty, například zadání hodnoty null s konkrétní přesností a měřítkem.

Poznámka

Použití této vlastnosti k předávání dat do databáze není podporováno. Pokud chcete data před předáním do databáze zaokrouhlit, zkrátit nebo jinak vymátit, použijte před přiřazením hodnoty k vlastnosti parametru MathValue třídu, která je součástí System oboru názvů.

Poznámka

Zprostředkovatelé dat rozhraní .NET Framework, kteří jsou součástí rozhraní .NET Framework verze 1.0, neověřují Precision hodnoty parametrů nebo ScaleDecimal . To může způsobit vložení zkrácených dat do zdroje dat. Pokud používáte rozhraní .NET Framework verze 1.0, před nastavením hodnoty parametru ověřte Precision hodnoty aSqlParameter.Decimal Scale hodnoty, které překračují měřítko parametru Decimal , jsou stále zkráceny.