OleDbParameter.Scale プロパティ

.NET Framework クラス ライブラリ リファレンス

OleDbParameter.Scale プロパティ

Value を解決するための小数部桁数を取得または設定します。

名前空間: System.Data.OleDb
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Property Scale As
 Byte

Visual Basic (使用法)

Dim instance As OleDbParameter
Dim value As Byte

value = instance.Scale

instance.Scale = value

C#

public byte Scale { get; set;
 }

C++

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

J#

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

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

JScript

public final function get
 Scale () : byte

public final function set
 Scale (value : byte)

プロパティ値
Value を解決するための小数部の桁数。既定値は 0 です。

解説

Scale プロパティは、OleDbCommand の Prepare メソッドを呼び出す前に 10 進および数値入力パラメータに対してのみ使用し、数値出力パラメータを指定するために使用します。

このプロパティをデータベース内の値以外の値に設定するかどうかはデータ プロバイダの実装に依存し、エラー コードが返されたり、データの切り捨てや丸めが行われたりします。

Scale プロパティは、OleDbType が Decimal、Numeric、または VarNumeric のパラメータにだけ影響します。それ以外のデータ型の場合、Scale は無視されます。

メモ
データベースに渡されるデータを変換するためのこのプロパティの使用はサポートされていません。データベースにデータを渡す前にデータを丸めたり、切り捨てたり、または変換したりするためには、パラメータの Value プロパティに値を割り当てる前に System 名前空間の一部である Math クラスを使用します。

メモ
.NET Framework Version 1.0 に付属の .NET Framework データ プロバイダでは、Decimal パラメータ値の Precision と Scale は検証されません。この結果、一部が切り捨てられたデータがデータ ソースに挿入される可能性があります。.NET Framework Version 1.0 をご使用の場合は、パラメータ値を設定する前に、Decimal 値の Precision と OleDbParameter を検証してください。Decimal パラメータの桁数を超えた Scale 値は、切り捨てられます。

使用例

OleDbParameter を作成し、そのプロパティの一部を設定する例を次に示します。

[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;
 }

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
OleDbParameter クラス
OleDbParameter メンバ
System.Data.OleDb 名前空間
その他の技術情報
コマンドの使用