Freigeben über


SqlParameter.Scale Eigenschaft

Definition

Ruft die Anzahl der Dezimalstellen ab, in die Value aufgelöst wird, oder legt diese fest.

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

Eigenschaftswert

Die Anzahl der Dezimalstellen, mit der Value aufgelöst wird. Die Standardeinstellung ist 0.

Implementiert

Beispiele

Im folgenden Beispiel wird ein SqlParameter erstellt und einige seiner Eigenschaften festgelegt.

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

Hinweise

Die Scale -Eigenschaft wird von Parametern mit einem SqlDbType von Decimalverwendet.

Warnung

Daten können abgeschnitten werden, wenn die Scale Eigenschaft nicht explizit angegeben ist und die Daten auf dem Server nicht in skalierung 0 (Standard) passen.

Sie müssen keine Werte für die Precision Eigenschaften und Scale für Eingabeparameter angeben, da sie aus dem Parameterwert abgeleitet werden können. Precision und Scale sind für Ausgabeparameter und für Szenarien erforderlich, in denen Sie vollständige Metadaten für einen Parameter angeben müssen, ohne einen Wert anzugeben, z. B. das Angeben eines NULL-Werts mit einer bestimmten Genauigkeit und Skalierung.

Hinweis

Die Verwendung dieser Eigenschaft zum Coerce-Daten, die an die Datenbank übergeben werden, wird nicht unterstützt. Um Daten zu runden, abzuschneiden oder anderweitig zu ermischen, bevor sie an die Datenbank übergeben werden, verwenden Sie die Math Klasse, die Teil des System Namespace ist, bevor Sie der Eigenschaft des Value Parameters einen Wert zuweisen.

Hinweis

.NET Framework Datenanbieter, die in der .NET Framework Version 1.0 enthalten sind, überprüfen die Precision Parameterwerte oder ScaleDecimal nicht. Dies kann dazu führen, dass abgeschnittene Daten an der Datenquelle eingefügt werden. Wenn Sie .NET Framework Version 1.0 verwenden, überprüfen Sie die Precision Werte undSqlParameter, Decimal bevor Sie den Parameterwert festlegen. Scale Werte, die die Decimal Parameterskala überschreiten, werden weiterhin abgeschnitten.

Gilt für: