SqlParameterCollection.Add メソッド (String, Object)

パラメータ名と値を指定して、 SqlParameter を SqlParameterCollection に追加します。

Overloads Public Function Add( _
   ByVal parameterName As String, _   ByVal value As Object _) As SqlParameter
[C#]
public SqlParameter Add(stringparameterName,objectvalue);
[C++]
public: SqlParameter* Add(String* parameterName,Object* value);
[JScript]
public function Add(
   parameterName : String,value : Object) : SqlParameter;

パラメータ

• parameterName
  パラメータの名前。
• value
  コレクションに追加する SqlParameter の Value 。

戻り値

新しい SqlParameter オブジェクトのインデックス。

例外

解説

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

parameters.Add("@pname", Convert.ToInt32(0));

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

使用例

 
Public Sub AddSqlParameter(cmd As SqlCommand) 
  cmd.Parameters.Add("@Description", "Beverages")
End Sub

[C#] 
public void AddSqlParameter(SqlCommand cmd) 
{
  cmd.Parameters.Add("@Description", "Beverages");
}

[C++] 
public:
    void AddSqlParameter(SqlCommand* cmd)
    {
        cmd->Parameters->Add(S"@Description", S"Beverages");
    };

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

SqlParameterCollection クラス | SqlParameterCollection メンバ | System.Data.SqlClient 名前空間 | SqlParameterCollection.Add オーバーロードの一覧