SqlParameterCollection クラス

定義

名前空間:

Microsoft.Data.SqlClient

アセンブリ:

Microsoft.Data.SqlClient.dll

パッケージ:

Microsoft.Data.SqlClient v5.2.0

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

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

[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : System.Data.Common.DbParameterCollection

[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit DbParameterCollection

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection

継承

DbParameterCollection

SqlParameterCollection

属性

ListBindableAttribute

例

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

using Microsoft.Data.SqlClient;
using System.Xml;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet categoriesDataSet;
    protected DataGrid dataGrid1;
    protected SqlDataAdapter categoriesAdapter;


    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);

    }
}

注釈

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

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

プロパティ

Count	SqlParameterCollection の要素数を格納している整数を返します。 読み取り専用です。
IsFixedSize	SqlParameterCollection が固定サイズかどうかを示す値を取得します。
IsReadOnly	SqlParameterCollection が読み取り専用かどうかを示す値を取得します。
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 のすべての要素をコピーします。その際、指定されたコピー先のインデックス位置からコピーを開始します。
GetEnumerator()	SqlParameterCollection を反復処理する列挙子を返します。
IndexOf(Object)	指定した Object のコレクション内での位置を取得します。
IndexOf(SqlParameter)	指定した SqlParameter のコレクション内での位置を取得します。
IndexOf(String)	指定された名前を持つ指定された SqlParameter の場所を取得します。
Insert(Int32, Object)	Object を SqlParameterCollection 内の指定されたインデックス位置に挿入します。
Insert(Int32, SqlParameter)	SqlParameter オブジェクトを SqlParameterCollection 内の指定されたインデックス位置に挿入します。
Remove(Object)	指定された SqlParameter をコレクションから削除します。
Remove(SqlParameter)	指定された SqlParameter をコレクションから削除します。
RemoveAt(Int32)	指定されたインデックス位置にある SqlParameter を SqlParameterCollection から削除します。
RemoveAt(String)	指定されたパラメーター名を持つ SqlParameter を SqlParameterCollection から削除します。