SqlParameter.Scale Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property Scale As ByteEigenschaftswert
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.