SqlParameter.Scale プロパティ

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

SqlParameter.Scale プロパティ

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

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

Visual Basic (宣言)

Public Property Scale As
 Byte

Visual Basic (使用法)

Dim instance As SqlParameter
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 プロパティは、SqlDbType が Decimal のパラメータで使用します。

入力パラメータの Precision プロパティとScale プロパティの値はパラメータ値から推論できるので指定する必要はありません。Precision と Scale は、出力パラメータに必要です。また、特定の精度とスケールで null 値を指定するなど、値を指定しないでパラメータの完全なメタデータを指定する必要があるシナリオにも必要です。

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

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

使用例

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

Visual Basic

Private Sub CreateSqlParameterPrecisionScale()
    Dim parameter As New
 SqlParameter("Price", SqlDbType.Decimal)
    parameter.Value = 3.1416
    parameter.Precision = 8
    parameter.Scale = 4
End Sub

C#

static void CreateSqlParameterPrecisionScale()
{
    SqlParameter parameter = new SqlParameter("Price",
 SqlDbType.Decimal);
    parameter.Value = 3.1416;
    parameter.Precision = 8;
    parameter.Scale = 4;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SqlParameter クラス
SqlParameter メンバ
System.Data.SqlClient 名前空間
その他の技術情報
ADO.NET でのデータへの接続およびデータの取得
.NET Framework Data Provider for SQL Server の使用