OleDbParameter.Scale Eigenschaft

Definition

Ruft die Anzahl der Dezimalstellen ab, in die Value aufgelöst wird, oder legt diese fest.Gets or sets the number of decimal places to which Value is resolved.

public:
 property System::Byte Scale { System::Byte get(); void set(System::Byte value); };
[System.Data.DataSysDescription("DbDataParameter_Scale")]
public byte Scale { get; set; }
member this.Scale : byte with get, set
Public Property Scale As Byte

Eigenschaftswert

Die Anzahl der Dezimalstellen, in die Value aufgelöst wird.The number of decimal places to which Value is resolved. Der Standard ist 0.The default is 0.

Implementiert

Attribute

Beispiele

Im folgenden Beispiel wird eine OleDbParameter erstellt und einige der zugehörigen Eigenschaften festgelegt.The following example creates an OleDbParameter and sets some of its properties.

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

Hinweise

Die Scale-Eigenschaft wird nur für die Eingabeparameter Decimal und numeric verwendet, bevor die Prepare-Methode des OleDbCommand aufgerufen und numerische Ausgabeparameter angegeben werden.The Scale property is only used for decimal and numeric input parameters before calling the Prepare method of the OleDbCommand and to specify numeric output parameters.

Wenn diese Eigenschaft auf einen anderen Wert als den Wert in der Datenbank festgelegt wird, hängt dies von der Implementierung des Datenanbieters ab und gibt möglicherweise einen Fehlercode, ein Abschneiden oder Runden von Daten zurück.Setting this property to a value other than the value in the database depends on the implementation of the data provider and may return an error code, truncate, or round data.

Wenn Sie SQL Server Native Client 10 (oder höher) verwenden, um einen Parameter zu binden, dessen Typ Decimal, Numeric, VarNumeric, DBDateoder DBTimeStampist, müssen Sie manuell einen entsprechenden Skalierungs Wert angeben.When using SQL Server Native Client 10 (or later), to bind a parameter whose type is Decimal, Numeric, VarNumeric, DBDate, or DBTimeStamp, you must manually specify an appropriate scale value.

Hinweis

Die Verwendung dieser Eigenschaft zum Umwandeln von Daten, die an die Datenbank übermittelt werden, wird nicht unterstützt.Use of this property to coerce data passed to the database is not supported. Wenn Sie Daten vor der Übergabe an die Datenbank Runden, abschneiden oder anderweitig umwandeln möchten, verwenden Sie die Math Klasse, die Teil des System-Namespace ist, bevor Sie der Value-Eigenschaft des Parameters einen Wert zuweisen.To round, truncate, or otherwise coerce data before passing it to the database, use the Math class that is part of the System namespace prior to assigning a value to the parameter's Value property.

Hinweis

.NET Framework Datenanbieter, die in der .NET Framework-Version 1,0 enthalten sind, überprüfen nicht die Precision oder Scale von Decimal Parameterwerten..NET Framework data providers that are included with the .NET Framework version 1.0 do not verify the Precision or Scale of Decimal parameter values. Dies kann dazu führen, dass abgeschnittene Daten an der Datenquelle eingefügt werden.This can cause truncated data to be inserted at the data source. Wenn Sie .NET Framework Version 1,0 verwenden, überprüfen Sie die Precision und OleDbParameter von Decimal Werten, bevor Sie den Parameterwert festlegen.If you are using .NET Framework version 1.0, validate the Precision and OleDbParameter of Decimal values before setting the parameter value. Scale Werte, die die Decimal Parameter Skala überschreiten, werden immer noch abgeschnitten.Scale values that exceed the Decimal parameter scale are still truncated.

Gilt für:

Siehe auch