SqlParameterCollection クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
SqlCommandに関連付けられたパラメーターのコレクションと、DataSet内の列への対応するマッピングを表します。 このクラスは継承できません。
新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。
public ref class SqlParameterCollection sealed : System::Data::Common::DbParameterCollectionpublic ref class SqlParameterCollection sealed : MarshalByRefObject, System::Collections::IList, System::Data::IDataParameterCollectionpublic 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.DbParameterCollectiontype 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 DbParameterCollectionPublic NotInheritable Class SqlParameterCollection
Inherits DbParameterCollectionPublic NotInheritable Class SqlParameterCollection
Inherits MarshalByRefObject
Implements IDataParameterCollection, IList- 継承
- 継承
- 継承
- 属性
- 実装
例
次の例では、SqlParameter コレクションを使用してSqlParameterCollectionの複数のインスタンスを作成します。 パラメーターは、データ ソース内のデータを選択し、 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必要があります。 ストアド プロシージャでは、既定値なしでストアド プロシージャで宣言されているすべてのパラメーターを指定する必要があります。 既定値で宣言されたパラメーターは省略可能です。 これにより、既定値以外の値を指定できます。
パラメーターの使用方法を示す追加のサンプル コードの詳細については、「 コマンドとパラメーター」を参照してください。
プロパティ
| Name | 説明 |
|---|---|
| Count |
SqlParameterCollection内の要素の数を含む整数を返します。 読み取り専用。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| IsFixedSize |
SqlParameterCollectionに固定サイズがあるかどうかを示す値を取得します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| IsReadOnly |
SqlParameterCollectionが読み取り専用かどうかを示す値を取得します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| IsSynchronized |
SqlParameterCollectionが同期されているかどうかを示す値を取得します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| Item[Int32] |
指定したインデックス位置にある SqlParameter を取得します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| Item[String] |
指定した名前の SqlParameter を取得します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| SyncRoot |
SqlParameterCollectionへのアクセスを同期するために使用できるオブジェクトを取得します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
メソッド
| Name | 説明 |
|---|---|
| Add(Object) |
指定した SqlParameter オブジェクトを SqlParameterCollectionに追加します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| Add(SqlParameter) |
指定した SqlParameter オブジェクトを SqlParameterCollectionに追加します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| Add(String, Object) |
古い.
指定した SqlParameter オブジェクトを SqlParameterCollectionに追加します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| Add(String, SqlDbType, Int32, String) |
パラメーター名、データ型、および列の長さを使用して、SqlParameterにSqlParameterCollectionを追加します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| Add(String, SqlDbType, Int32) |
指定したパラメーター名、SqlParameter、サイズを指定して、SqlParameterCollectionにSqlDbTypeを追加します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| Add(String, SqlDbType) |
パラメーター名とデータ型を指定して、SqlParameterにSqlParameterCollectionを追加します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| AddRange(Array) |
SqlParameterCollectionの末尾に値の配列を追加します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| AddRange(SqlParameter[]) |
SqlParameterの末尾にSqlParameterCollection値の配列を追加します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| AddWithValue(String, Object) |
SqlParameterCollectionの末尾に値を追加します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| Clear() |
SqlParameterからすべてのSqlParameterCollection オブジェクトを削除します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| Contains(Object) |
指定した Object がこの SqlParameterCollection内にあるかどうかを判断します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| Contains(SqlParameter) |
指定した SqlParameter がこの SqlParameterCollection内にあるかどうかを判断します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| Contains(String) |
指定したパラメーター名がこの SqlParameterCollection内にあるかどうかを判断します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| CopyTo(Array, Int32) |
現在のSqlParameterCollectionのすべての要素を、指定したコピー先のインデックスから始まる指定した 1 次元ArrayArrayコピーします。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| CopyTo(SqlParameter[], Int32) |
現在の SqlParameterCollection のすべての要素を、指定したコピー先インデックスから始まる指定した SqlParameterCollection にコピーします。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| CreateObjRef(Type) |
リモート オブジェクトとの通信に使用されるプロキシの生成に必要なすべての関連情報を含むオブジェクトを作成します。 (継承元 MarshalByRefObject) |
| Equals(Object) |
指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
| GetEnumerator() |
SqlParameterCollectionを反復処理する列挙子を返します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
| GetLifetimeService() |
古い.
このインスタンスの有効期間ポリシーを制御する現在の有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject) |
| GetParameter(Int32) |
コレクション内の指定したインデックス位置にある DbParameter オブジェクトを返します。 (継承元 DbParameterCollection) |
| GetParameter(String) |
指定した名前のオブジェクト DbParameter 返します。 (継承元 DbParameterCollection) |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| IndexOf(Object) |
コレクション内の指定した Object の場所を取得します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| IndexOf(SqlParameter) |
コレクション内の指定した SqlParameter の場所を取得します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| IndexOf(String) |
指定した名前の指定した SqlParameter の場所を取得します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| InitializeLifetimeService() |
古い.
このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject) |
| Insert(Int32, Object) |
指定したインデックス位置にあるObjectにSqlParameterCollectionを挿入します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| Insert(Int32, SqlParameter) |
指定したインデックス位置にあるSqlParameterにSqlParameterCollection オブジェクトを挿入します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| MemberwiseClone() |
現在の Objectの簡易コピーを作成します。 (継承元 Object) |
| MemberwiseClone(Boolean) |
現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject) |
| Remove(Object) |
指定した SqlParameter をコレクションから削除します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| Remove(SqlParameter) |
指定した SqlParameter をコレクションから削除します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| RemoveAt(Int32) |
指定したインデックス位置にあるSqlParameterからSqlParameterCollectionを削除します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| RemoveAt(String) |
指定したパラメーター名のSqlParameterからSqlParameterCollectionを削除します。 新しい開発では、Microsoftを使用します。Data.SqlClient。 このページでは、System.Data.SqlClient について説明します。 |
| SetParameter(Int32, DbParameter) |
指定したインデックス位置にある DbParameter オブジェクトを新しい値に設定します。 (継承元 DbParameterCollection) |
| SetParameter(String, DbParameter) |
指定した名前の DbParameter オブジェクトを新しい値に設定します。 (継承元 DbParameterCollection) |
| ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
明示的なインターフェイスの実装
| Name | 説明 |
|---|---|
| ICollection.IsSynchronized |
ICollectionへのアクセスが同期されているかどうかを示す値を取得します (スレッド セーフ)。 (継承元 DbParameterCollection) |
| IDataParameterCollection.Item[String] |
指定したインデックス位置にあるパラメーターを取得または設定します。 (継承元 DbParameterCollection) |
| IList.IsFixedSize |
IListに固定サイズがあるかどうかを示す値を取得します。 (継承元 DbParameterCollection) |
| IList.IsReadOnly |
IListが読み取り専用かどうかを示す値を取得します。 (継承元 DbParameterCollection) |
| IList.Item[Int32] |
指定したインデックス位置にある要素を取得または設定します。 (継承元 DbParameterCollection) |
拡張メソッド
| Name | 説明 |
|---|---|
| AsParallel(IEnumerable) |
クエリの並列化を有効にします。 |
| AsQueryable(IEnumerable) |
IEnumerable を IQueryableに変換します。 |
| Cast<TResult>(IEnumerable) |
IEnumerable の要素を指定した型にキャストします。 |
| OfType<TResult>(IEnumerable) |
指定した型に基づいて、IEnumerable の要素をフィルター処理します。 |
