OleDbParameter.Precision プロパティ

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

OleDbParameter.Precision プロパティ

Value プロパティを表すときに使用する最大桁数を取得または設定します。

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

Visual Basic (宣言)

Public Property Precision As
 Byte

Visual Basic (使用法)

Dim instance As OleDbParameter
Dim value As Byte

value = instance.Precision

instance.Precision = value

C#

public byte Precision { get; set;
 }

C++

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

J#

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

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

JScript

public final function get
 Precision () : byte

public final function set
 Precision (value : byte)

プロパティ値
Value プロパティを表すための最大桁数。既定値は 0 です。この場合、Value の精度はデータ プロバイダによって設定されます。

解説

Precision プロパティは、10 進および数値の入力パラメータだけで使用します。

Precision プロパティは、OleDbCommand の Prepare メソッドを呼び出す前に Decimal パラメータおよび Numeric パラメータに対してのみ設定する必要があります。

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

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

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

メモ
.NET Framework Version 1.0 に付属の .NET Framework データ プロバイダでは、Decimal パラメータ値の Precision と Scale は検証されません。この結果、一部が切り捨てられたデータがデータ ソースに挿入される可能性があります。.NET Framework Version 1.0 をご使用の場合は、パラメータ値を設定する前に、Decimal 値の Precision と Scale を検証してください。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 名前空間
その他の技術情報
コマンドの使用