次の方法で共有


ObjectParameterCollection.Add(ObjectParameter) メソッド

定義

指定された 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

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

実装

例外

parameter 引数が null です。

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

- または -

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

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 メソッド」を参照してください。

適用対象

こちらもご覧ください