SqlParameter.Scale-Eigenschaft

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

Namespace: System.Data.SqlClient
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Property Scale As Byte
'Usage
Dim instance As SqlParameter
Dim value As Byte

value = instance.Scale

instance.Scale = value

public byte Scale { get; set; }

public:
virtual property unsigned char Scale {
    unsigned char get () sealed;
    void set (unsigned char value) sealed;
}

/** @property */
public final byte get_Scale ()

/** @property */
public final void set_Scale (byte value)

public final function get Scale () : byte

public final function set Scale (value : byte)

Eigenschaftenwert

Die Anzahl der Dezimalstellen, in die der Value aufgelöst wird. Der Standardwert ist 0 (null).

Hinweise

Die Scale-Eigenschaft wird von Parametern verwendet, deren SqlDbTypeDecimal ist.

Sie müssen bei Eingabeparametern keine Werte für die Precision-Eigenschaft und die Scale-Eigenschaft angeben, da diese aus dem Parameterwert abgeleitet werden können. Precision und Scale sind für Ausgabeparameter und in Situationen erforderlich, in denen Sie vollständige Metadaten für einen Parameter angeben müssen, ohne einen Wert anzugeben, z. B. durch Angabe eines NULL-Werts mit einer bestimmten Genauigkeit und Skalierung.

Hinweis

Die Verwendung dieser Eigenschaft zum Umwandeln von an die Datenbank übergebenen Daten wird nicht unterstützt. Zum Runden, Abschneiden oder Umwandeln der Daten vor dem Übergeben an die Datenbank verwenden Sie die Math-Klasse im System-Namespace, bevor Sie der Value-Eigenschaft des Parameters einen Wert zuweisen.

Hinweis

Die im Lieferumfang von .NET Framework, Version 1.0, enthaltenen .NET Framework-Datenanbieter führen keine Überprüfung von Precision oder Scale für die Decimal-Parameterwerte durch. Dies kann dazu führen, dass abgeschnittene Daten in die Datenquelle eingefügt werden. Wenn Sie .NET Framework, Version 1.0, verwenden, sollten Sie Precision und SqlParameter für die Decimal-Werte validieren, bevor Sie den Parameterwert festlegen. Scale-Werte, die die Decimal-Parameterskalierung überschreiten, werden weiterhin abgeschnitten.

Beispiel

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

Private Sub CreateSqlParameterPrecisionScale()
    Dim parameter As New SqlParameter("Price", SqlDbType.Decimal)
    parameter.Value = 3.1416
    parameter.Precision = 8
    parameter.Scale = 4
End Sub

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

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SqlParameter-Klasse
SqlParameter-Member
System.Data.SqlClient-Namespace

Weitere Ressourcen

Verbinden und Abrufen von Daten mit ADO.NET
Verwenden des .NET Framework-Datenanbieters für SQL Server