ObjectParameterCollection.Add(ObjectParameter) メソッド

定義

名前空間:

System.Data.Objects

アセンブリ:

System.Data.Entity.dll

指定された ObjectParameter をコレクションに追加します。

public:
 virtual void Add(System::Data::Objects::ObjectParameter ^ parameter);

public void Add (System.Data.Objects.ObjectParameter parameter);

abstract member Add : System.Data.Objects.ObjectParameter -> unit
override this.Add : System.Data.Objects.ObjectParameter -> unit

Public Sub Add (parameter As ObjectParameter)

パラメーター

parameter

ObjectParameter

コレクションに追加するパラメーター。

実装

Add(T)

例外

ArgumentNullException

parameter 引数が null です。

ArgumentException

引数 parameter はコレクション内に既に存在します。 この動作は、エントリの重複を許可するほとんどのコレクションの動作とは異なります。

- または -

引数 parameter と同じ名前を持つ別のパラメーターがコレクション内に既に存在します。 参照では大文字と小文字が区別されないことに注意してください。 この動作は、ほとんどのコレクションの動作とは異なり、むしろ Dictionary<TKey,TValue> の動作に似ています。

ArgumentOutOfRangeException

parameter の型が有効ではありません。

例

次の使用例は、新しいパラメーターをコレクションに追加します。 ObjectParameterCollection を反復処理し、コレクション内の各パラメーターの名前、型、および値を表示します。

using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    string queryString =
        @"SELECT VALUE contact FROM AdventureWorksEntities.Contacts
        AS contact WHERE contact.LastName = @ln AND contact.FirstName = @fn";

    ObjectQuery<Contact> contactQuery =
        new ObjectQuery<Contact>(queryString, context);

    // Add parameters to the collection.
    contactQuery.Parameters.Add(new ObjectParameter("ln", "Adams"));
    contactQuery.Parameters.Add(new ObjectParameter("fn", "Frances"));

    ObjectParameterCollection objectParameterCollection =
        contactQuery.Parameters;

    Console.WriteLine("Count is {0}.", objectParameterCollection.Count);

    // Iterate through the ObjectParameterCollection collection.
    foreach (ObjectParameter result in objectParameterCollection)
    {
        Console.WriteLine("{0} {1} {2}", result.Name,
            result.Value,
            result.ParameterType);
    }
}

注釈

クエリがコンパイルまたは実行されていない限り、パラメーターを追加した後で、コレクションからパラメーターを削除することも、コレクションをクリアすることもできます。 パラメーター名は変更できませんが、値はいつでも変更できます。

パラメーターは、ObjectParameterCollection 内で一意である必要があります。 コレクション内に同じ名前のパラメーターが 2 つ存在することはできません。 詳細については、「 Query Builder メソッド」を参照してください。

こちらもご覧ください

• オブジェクトとしてのデータのクエリと結果の整形 (Entity Framework)