SqlParameterCollection クラス

リファレンス

定義

名前空間:: System.Data.SqlClient

アセンブリ:: System.Data.SqlClient.dll

アセンブリ:: System.Data.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

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

public ref class SqlParameterCollection sealed : MarshalByRefObject, System::Collections::IList, System::Data::IDataParameterCollection

public ref class SqlParameterCollection sealed : System::Data::Common::DbParameterCollection, System::Collections::IList

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

[System.ComponentModel.ListBindable(false)]
public sealed class SqlParameterCollection : MarshalByRefObject, System.Collections.IList, System.Data.IDataParameterCollection

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

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

type SqlParameterCollection = class
    inherit DbParameterCollection

[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit MarshalByRefObject
    interface IDataParameterCollection
    interface IList
    interface ICollection
    interface IEnumerable

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

[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
    inherit DbParameterCollection
    interface IDataParameterCollection
    interface IList
    interface ICollection
    interface IEnumerable

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection

Public NotInheritable Class SqlParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, IList

Public NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection
Implements IList

継承: Object

DbParameterCollection
SqlParameterCollection

継承: Object

MarshalByRefObject

DbParameterCollection
SqlParameterCollection

継承: Object

MarshalByRefObject
SqlParameterCollection

属性: ListBindableAttribute

実装: ICollection IEnumerable IList IDataParameterCollection

例

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

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

メソッド

Add(Object)	指定した SqlParameter オブジェクトを SqlParameterCollection に追加します。
Add(SqlParameter)	指定した SqlParameter オブジェクトを SqlParameterCollection に追加します。
Add(String, Object)	互換性のために残されています。互換性のために残されています。指定した 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 のすべての要素をコピーします。その際、指定されたコピー先のインデックス位置からコピーを開始します。
CreateObjRef(Type)	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (継承元 MarshalByRefObject)
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetEnumerator()	SqlParameterCollection を反復処理する列挙子を返します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetLifetimeService()	互換性のために残されています。対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
GetParameter(Int32)	コレクション内の指定したインデックス位置にある DbParameter オブジェクトを返します。 (継承元 DbParameterCollection)
GetParameter(String)	指定した名前の DbParameter オブジェクトを返します。 (継承元 DbParameterCollection)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
IndexOf(Object)	指定した Object のコレクション内での位置を取得します。
IndexOf(SqlParameter)	指定した SqlParameter のコレクション内での位置を取得します。
IndexOf(String)	指定された名前を持つ指定された SqlParameter の場所を取得します。
InitializeLifetimeService()	互換性のために残されています。このインスタンスの有効期間ポリシーを制御する有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
Insert(Int32, Object)	Object を SqlParameterCollection 内の指定されたインデックス位置に挿入します。
Insert(Int32, SqlParameter)	SqlParameter オブジェクトを SqlParameterCollection 内の指定されたインデックス位置に挿入します。
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
MemberwiseClone(Boolean)	現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject)
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)

明示的なインターフェイスの実装

ICollection.IsSynchronized	ICollection へのアクセスが同期されている (スレッドセーフである) かどうかを示す値を取得します。 (継承元 DbParameterCollection)
IDataParameterCollection.Item[String]	指定したインデックスにあるパラメーターを取得または設定します。 (継承元 DbParameterCollection)
IList.IsFixedSize	IList が固定サイズかどうかを示す値を取得します。 (継承元 DbParameterCollection)
IList.IsReadOnly	IList が読み取り専用かどうかを示す値を取得します。 (継承元 DbParameterCollection)
IList.Item[Int32]	指定したインデックスにある要素を取得または設定します。 (継承元 DbParameterCollection)

拡張メソッド

Cast<TResult>(IEnumerable)	IEnumerable の要素を、指定した型にキャストします。
OfType<TResult>(IEnumerable)	指定された型に基づいて IEnumerable の要素をフィルター処理します。
AsParallel(IEnumerable)	クエリの並列化を有効にします。
AsQueryable(IEnumerable)	IEnumerable を IQueryable に変換します。

適用対象