SqlParameter.Precision プロパティ

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

SqlParameter.Precision プロパティ

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

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

Visual Basic (宣言)

Public Property Precision As
 Byte

Visual Basic (使用法)

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

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

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

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

使用例

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

Visual Basic

Private Sub AddSqlParameter(ByVal
 command As SqlCommand)

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

    command.Parameters.Add(parameter)
End Sub

C#

private static void AddSqlParameter(SqlCommand
 command)
{
    SqlParameter parameter = new SqlParameter("@Price",
 SqlDbType.Decimal);
    parameter.Value = 3.1416;
    parameter.Precision = 8;
    parameter.Scale = 4;

    command.Parameters.Add(parameter);
}

プラットフォーム

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 の使用