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 つ含めることはできません。 詳細については、「 クエリ ビルダーメソッド」を参照してください。

適用対象

こちらもご覧ください