SqlParameter コンストラクタ (String, Object)

2007-08-14

パラメータ名と新しい SqlParameter の値を指定して、SqlParameter クラスの新しいインスタンスを初期化します。

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

構文

'宣言
Public Sub New ( _
    parameterName As String, _
    value As Object _
)
'使用
Dim parameterName As String
Dim value As Object

Dim instance As New SqlParameter(parameterName, value)

public SqlParameter (
    string parameterName,
    Object value
)

public:
SqlParameter (
    String^ parameterName, 
    Object^ value
)

public SqlParameter (
    String parameterName, 
    Object value
)

public function SqlParameter (
    parameterName : String, 
    value : Object
)

パラメータ

parameterName
割り当てるパラメータの名前。

value
SqlParameter の値を示す Object。

解説

value パラメータで Object を指定すると、SqlDbType は、Object の Microsoft .NET Framework 型から推論されます。

SqlParameter コンストラクタのこのオーバーロードを使用して整数のパラメータ値を指定する場合は、注意する必要があります。このオーバーロードは Object 型の value を受け取るため、次の C# の例のように、値が 0 の場合に整数値を Object 型に変換する必要があります。

Parameter = new SqlParameter("@pname", Convert.ToInt32(0));

この変換を行わないと、コンパイラは、SqlParameter (string, SqlDbType) コンストラクタオーバーロードを呼び出そうとしていると見なします。

使用例

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

Private Sub AddSqlParameter(ByVal command As SqlCommand)

    Dim parameter As New SqlParameter("@Description", _
        SqlDbType.VarChar, 88, "Description")
    With parameter
        .IsNullable = True
        .Direction = ParameterDirection.Output
    End With

    command.Parameters.Add(parameter)
End Sub

private static void AddSqlParameter(SqlCommand command)
{
    SqlParameter parameter = new SqlParameter("@Description", 
        SqlDbType.VarChar, 88, "Description");
    parameter.IsNullable = true;
    parameter.Direction = ParameterDirection.Output;

    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

参照

その他の技術情報

ADO.NET でのデータへの接続およびデータの取得
 .NET Framework Data Provider for SQL Server の使用