SqlParameterCollection クラス

定義

名前空間:

System.Data.SqlClient

アセンブリ:

System.Data.SqlClient.dll

パッケージ:

System.Data.SqlClient v4.8.6

SqlCommand に関連付けられたパラメーターと、DataSet 内の列に対するそれぞれのマッピング コレクションを表します。 このクラスは継承できません。

public ref class SqlParameterCollection sealed : System::Data::Common::DbParameterCollection

public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection

type SqlParameterCollection = class
    inherit DbParameterCollection

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection

継承

Object

DbParameterCollection

SqlParameterCollection

例

次の例では、 コレクションを使用して の SqlParameter 複数のインスタンスを SqlParameterCollection 作成します。 パラメーターは、データ ソース内のデータを選択し、 を設定するために使用されます DataSet。 このコードでは、 と SqlDataAdapter がDataSet適切なスキーマ、コマンド、接続で既に作成されていることを前提としています。

public void AddSqlParameters()
{
// ...
// create categoriesDataSet and categoriesAdapter
// ...

  categoriesAdapter.SelectCommand.Parameters.Add(
    "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters";
  categoriesAdapter.SelectCommand.Parameters.Add(
    "@SerialNum", SqlDbType.Int).Value = 239;
  categoriesAdapter.Fill(categoriesDataSet);
}

Public Sub AddSqlParameters()
    ' ...
    ' create categoriesDataSet and categoriesAdapter
    ' ...
    categoriesAdapter.SelectCommand.Parameters.Add( _
        "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters"
    categoriesAdapter.SelectCommand.Parameters.Add( _
        "@SerialNum", SqlDbType.Int).Value = 239
    
    categoriesAdapter.Fill(categoriesDataSet)
End Sub

注釈

ストアド プロシージャ名ではなく、コマンドにアドホック SQL ステートメントが含まれている場合、コレクション内のパラメーターの数は、コマンド テキスト内のパラメーター プレースホルダーの数と等しいか、エラーが発生SQL Server必要があります。 ストアド プロシージャでは、既定値なしでストアド プロシージャで宣言されているすべてのパラメーターを指定する必要があります。 既定値で宣言されたパラメーターは省略可能です。 これにより、既定値以外の値を指定できます。

パラメーターの使用方法を示す追加のサンプル コードの詳細については、「 コマンドとパラメーター」を参照してください。

プロパティ

Count	SqlParameterCollection の要素数を格納している整数を返します。 読み取り専用です。
IsFixedSize	SqlParameterCollection が固定サイズかどうかを示す値を取得します。
IsReadOnly	SqlParameterCollection が読み取り専用かどうかを示す値を取得します。
IsSynchronized	コレクションが同期されているかどうかを指定します。 (継承元 DbParameterCollection)
Item[Int32]	指定されたインデックス位置にある SqlParameter を取得します。
Item[String]	指定された名前を持つ SqlParameter を取得します。
SyncRoot	SqlParameterCollection へのアクセスを同期するために使用できるオブジェクトを取得します。

メソッド

Add(Object)	指定した SqlParameter オブジェクトを SqlParameterCollection に追加します。
Add(SqlParameter)	指定した SqlParameter オブジェクトを SqlParameterCollection に追加します。
Add(String, SqlDbType)	指定されたパラメーター名とデータ型を持つ SqlParameter を SqlParameterCollection に追加します。
Add(String, SqlDbType, Int32)	パラメーター名、SqlParameter、およびサイズを指定して、SqlParameterCollection を SqlDbType に追加します。
Add(String, SqlDbType, Int32, String)	指定されたパラメーター名、データ型、および列長を持つ SqlParameter を SqlParameterCollection に追加します。
AddRange(Array)	値の配列を SqlParameterCollection の末尾に追加します。
AddRange(SqlParameter[])	SqlParameter 値の配列を SqlParameterCollection の末尾に追加します。
AddWithValue(String, Object)	値を SqlParameterCollection の末尾に追加します。
Clear()	SqlParameter からすべての SqlParameterCollection オブジェクトを削除します。
Contains(Object)	指定された Object がこの SqlParameterCollection に含まれているかどうかを調べます。
Contains(SqlParameter)	指定された SqlParameter がこの SqlParameterCollection に含まれているかどうかを調べます。
Contains(String)	指定したパラメーター名がこの SqlParameterCollection にあるかどうかを確認します。
CopyTo(Array, Int32)	指定された 1 次元 SqlParameterCollection に現在の Array のすべての要素をコピーします。その際、指定されたコピー先の Array インデックス位置からコピーを開始します。
CopyTo(SqlParameter[], Int32)	指定された SqlParameterCollection に現在の SqlParameterCollection のすべての要素をコピーします。その際、指定されたコピー先のインデックス位置からコピーを開始します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetEnumerator()	SqlParameterCollection を反復処理する列挙子を返します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetParameter(Int32)	コレクション内の指定したインデックス位置にある DbParameter オブジェクトを返します。 (継承元 DbParameterCollection)
GetParameter(String)	指定した名前の DbParameter オブジェクトを返します。 (継承元 DbParameterCollection)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
IndexOf(Object)	指定した Object のコレクション内での位置を取得します。
IndexOf(SqlParameter)	指定した SqlParameter のコレクション内での位置を取得します。
IndexOf(String)	指定された名前を持つ指定された SqlParameter の場所を取得します。
Insert(Int32, Object)	Object を SqlParameterCollection 内の指定されたインデックス位置に挿入します。
Insert(Int32, SqlParameter)	SqlParameter オブジェクトを SqlParameterCollection 内の指定されたインデックス位置に挿入します。
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
Remove(Object)	指定された SqlParameter をコレクションから削除します。
Remove(SqlParameter)	指定された SqlParameter をコレクションから削除します。
RemoveAt(Int32)	指定されたインデックス位置にある SqlParameter を SqlParameterCollection から削除します。
RemoveAt(String)	指定されたパラメーター名を持つ SqlParameter を SqlParameterCollection から削除します。
SetParameter(Int32, DbParameter)	指定したインデックスの DbParameter オブジェクトを新しい値に設定します。 (継承元 DbParameterCollection)
SetParameter(String, DbParameter)	指定した名前の DbParameter オブジェクトを新しい値に設定します。 (継承元 DbParameterCollection)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

拡張メソッド

こちらもご覧ください

• コマンドとパラメーター (ADO.NET)
• DataAdapter パラメーター (ADO.NET)
• SQL Serverに.NET Framework データ プロバイダーを使用する
• ADO.NET の概要