OdbcParameter.Scale プロパティ

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

OdbcParameter.Scale プロパティ

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

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

Visual Basic (宣言)

Public Property Scale As
 Byte

Visual Basic (使用法)

Dim instance As OdbcParameter
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 プロパティは、10 進の数値の入力パラメータでだけ使用します。

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

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

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

メモ
.NET Framework Version 1.0 に付属の .NET Framework データ プロバイダでは、Decimal パラメータ値の scale は検証されません。この結果、変更されたデータがデータ ソースに挿入される可能性があります。.NET Framework Version 1.0 をご使用の場合、パラメータ値を設定する前に decimal の scale の値を検証してください。.NET Framework Version 1.1 以降を使用する場合、decimal パラメータの桁数を超える scale の値は、基になる ODBC ドライバの動作として規定されている場合、桁数でだけ切り捨てられることがあります。

使用例

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

[Visual Basic]

Public Sub CreateOdbcParameter()
    Dim parameter As New OdbcParameter("Price", OdbcType.Decimal)
    parameter.Value = 3.1416
    parameter.Precision = 8
    parameter.Scale = 4
End Sub 

[C#]

public void CreateOdbcParameter() 
 {
    OdbcParameter parameter = new OdbcParameter("Price", OdbcType.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

参照

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