OleDbParameter.Scale-Eigenschaft

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

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

Syntax

'Declaration
Public Property Scale As Byte
'Usage
Dim instance As OleDbParameter
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.

Hinweise

Die Scale-Eigenschaft wird nur für dezimale und numerische Parameter verwendet, bevor die Prepare-Methode des OleDbCommand aufgerufen wird, um numerische Ausgabeparameter anzugeben.

Das Festlegen dieser Eigenschaft auf einen anderen Wert als den in der Datenbank ist von der Implementierung des Datenanbieters abhängig und kann einen Fehlercode bzw. abgeschnittene oder gerundete Daten zur Folge haben.

Die Scale-Eigenschaft beeinflusst nur Parameter, deren OleDbType Decimal, Numeric oder VarNumeric ist. Bei anderen Datentypen wird Scale ignoriert.

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 OleDbParameter 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 OleDbParameter erstellt, und einige seiner Eigenschaften werden festgelegt.

[Visual Basic]

Public Sub CreateOleDbParameter()
    Dim parameter As New OleDbParameter("Price", OleDbType.Decimal)
    parameter.Value = 3.1416
    parameter.Precision = 8
    parameter.Scale = 4
End Sub 'CreateOleDbParameter

[C#]

public void CreateOleDbParameter() 
 {
    OleDbParameter parameter = new OleDbParameter("Price", OleDbType.Decimal);
    parameter.Value = 3.1416;
    parameter.Precision = 8;
    parameter.Scale = 4;
 }

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

Siehe auch

Referenz

OleDbParameter-Klasse
OleDbParameter-Member
System.Data.OleDb-Namespace

Weitere Ressourcen

Arbeiten mit Befehlen