SqlParameterCollection クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
SqlCommandに関連付けられたパラメーターのコレクションと、DataSet内の列への対応するマッピングを表します。 このクラスは継承できません。
public ref class SqlParameterCollection sealed : MarshalByRefObject, System::Collections::IList, System::Data::IDataParameterCollectionpublic ref class SqlParameterCollection sealed : 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)>]
type SqlParameterCollection = class
inherit MarshalByRefObject
interface IDataParameterCollection
interface IList
interface ICollection
interface IEnumerable[<System.ComponentModel.ListBindable(false)>]
type SqlParameterCollection = class
inherit DbParameterCollectionPublic NotInheritable Class SqlParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, IListPublic NotInheritable Class SqlParameterCollection
Inherits DbParameterCollection- 継承
- 継承
- 属性
- 実装
例
次の例では、SqlParameterCollection コレクションを使用してSqlParameterの複数のインスタンスを作成します。 パラメーターは、データ ソース内のデータを選択し、 DataSetを設定するために使用されます。 このコードは、適切なスキーマ、コマンド、接続を使用して、 DataSet と SqlDataAdapter が既に作成されていることを前提としています。
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 |
SqlParameterCollectionが同期されているかどうかを示す値を取得します。 |
| Item[Int32] |
指定したインデックス位置にある SqlParameter を取得します。 |
| Item[String] |
指定した名前の SqlParameter を取得します。 |
| SyncRoot |
SqlParameterCollectionへのアクセスを同期するために使用できるオブジェクトを取得します。 |
メソッド
明示的なインターフェイスの実装
| 名前 | 説明 |
|---|---|
| IDataParameterCollection.Item[String] |
指定したインデックス位置にあるパラメーターを取得または設定します。 (継承元 DbParameterCollection) |
| IList.Item[Int32] |
指定したインデックス位置にある要素を取得または設定します。 (継承元 DbParameterCollection) |
拡張メソッド
| 名前 | 説明 |
|---|---|
| AsParallel(IEnumerable) |
クエリの並列化を有効にします。 |
| AsQueryable(IEnumerable) |
IEnumerable を IQueryableに変換します。 |
| Cast<TResult>(IEnumerable) |
IEnumerable の要素を指定した型にキャストします。 |
| OfType<TResult>(IEnumerable) |
指定した型に基づいて、IEnumerable の要素をフィルター処理します。 |