SqlParameterCollection クラス

SqlCommand に関連するパラメータ コレクション、および DataSet 列に対する各パラメータのマップを表します。このクラスは継承できません。

この型のすべてのメンバの一覧については、SqlParameterCollection メンバ を参照してください。

System.Object
   System.MarshalByRefObject
      System.Data.SqlClient.SqlParameterCollection

NotInheritable Public Class SqlParameterCollection
   Inherits MarshalByRefObject
   Implements IDataParameterCollection, IList, ICollection, _
   IEnumerable
[C#]
public sealed class SqlParameterCollection : MarshalByRefObject,
   IDataParameterCollection, IList, ICollection, IEnumerable
[C++]
public __gc __sealed class SqlParameterCollection : public
   MarshalByRefObject, IDataParameterCollection, IList,
   ICollection,
   IEnumerable
[JScript]
public class SqlParameterCollection extends MarshalByRefObject
   implements IDataParameterCollection, IList, ICollection,
   IEnumerable

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

コレクション内のパラメータ数は、コマンド テキスト内のパラメータ プレースホルダの数と同じにする必要があります。これらが異なると、SQL Server がエラーを発生します。

使用例

[Visual Basic, C#, C++] SqlDataAdapter の SqlParameterCollection コレクションを使用して、 SqlParameter の複数のインスタンスを作成する例を次に示します。これらのパラメータを使用して、データ ソース内のデータを選択し、 DataSet にデータを格納します。このコードでは、 DataSet および SqlDataAdapter が、適切なスキーマ、コマンド、および接続で既に作成されていることを前提にしています。

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

[C#] 
public void AddSqlParameters() 
{
// ...
// create myDataSet and myDataAdapter
// ...

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

}

[C++] 
public:
void AddSqlParameters() 
{
// ...
// create myDataSet and myDataAdapter
// ...

  myDataAdapter->SelectCommand->Parameters->Add(S"@CategoryName", SqlDbType::VarChar, 80)->Value = S"toasters";
  myDataAdapter->SelectCommand->Parameters->Add(S"@SerialNum", SqlDbType::Int)->Value = __box(239);
  myDataAdapter->Fill(myDataSet);

}

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

必要条件

名前空間: System.Data.SqlClient

プラットフォーム: 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

アセンブリ: System.Data (System.Data.dll 内)

参照

SqlParameterCollection メンバ | System.Data.SqlClient 名前空間