ObjectParameterCollection.Add(ObjectParameter) Metoda

  • Reference

Definice

Obor názvů:
System.Data.Objects
Sestavení:
System.Data.Entity.dll

Přidá zadaný ObjectParameter objekt do kolekce.

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)

Parametry

parameter
ObjectParameter

Parametr, který se má přidat do kolekce.

Implementuje

Add(T)

Výjimky

ArgumentNullException

Argument parameter je null.

ArgumentException

Argument parameter již v kolekci existuje. Toto chování se liší od chování většiny kolekcí, které umožňují duplicitní položky.

-nebo-

Jiný parametr se stejným názvem jako parameter argument již v kolekci existuje. Všimněte si, že vyhledávání nerozlišuje velká a malá písmena. Toto chování se liší od chování většiny kolekcí a podobá se spíše chování objektu Dictionary<TKey,TValue>.

ArgumentOutOfRangeException

Typ není parameter platný.

Příklady

Tento příklad přidá do kolekce nové parametry. Iteruje přes ObjectParameterCollection a zobrazuje název, typ a hodnotu každého parametru v kolekci.

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);
    }
}

Poznámky

Po přidání parametrů je možné odebrat z kolekce a kolekci vymazat, pokud nebyl dotaz zkompilován nebo proveden. Názvy parametrů nelze změnit, ale hodnoty lze kdykoli změnit.

Parametry musí být v parametru ObjectParameterCollectionjedinečné. V kolekci nesmí být dva parametry se stejným názvem. Další informace najdete v tématu Metody Tvůrce dotazů.

Platí pro

Viz také