ObjectParameterCollection.Add(ObjectParameter) Methode

  • Referenz

Definition

Namespace:
System.Data.Objects
Assembly:
System.Data.Entity.dll

Fügt der Auflistung den angegebenen ObjectParameter hinzu.

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

parameter
ObjectParameter

Der der Auflistung hinzuzufügende Parameter.

Implementiert

Add(T)

Ausnahmen

ArgumentNullException

Das parameter-Argument lautet null.

ArgumentException

Das parameter-Argument ist bereits in der Auflistung vorhanden. Dieses Verhalten unterscheidet sich von dem der meisten Auflistungen, die doppelte Einträge zulassen.

- oder -

Ein weiterer Parameter, der den gleichen Namen wie das parameter-Argument aufweist, ist bereits in der Auflistung vorhanden. Beachten Sie, dass bei der Suche die Groß- und Kleinschreibung nicht beachtet wird. Dieses Verhalten unterscheidet sich von dem der meisten Auflistungen und ähnelt dem eines Dictionary<TKey,TValue>.

ArgumentOutOfRangeException

Der Typ des parameter ist ungültig.

Beispiele

In diesem Beispiel werden der Auflistung neue Parameter hinzugefügt. Die ObjectParameterCollection wird durchlaufen, und für jeden Parameter in der Auflistung werden Name, Typ und Wert angezeigt.

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

Hinweise

Hinzugefügte Parameter können aus der Auflistung entfernt und die Auflistung kann gelöscht werden, solange die Abfrage nicht kompiliert oder ausgeführt wurde. Parameternamen können nicht geändert werden, Werte können jedoch jederzeit geändert werden.

Die Parameter müssen in der ObjectParameterCollection eindeutig sein. Es können sich nicht zwei Parameter mit demselben Namen in der Auflistung befinden. Weitere Informationen finden Sie unter Abfrage-Generator-Methoden.

Gilt für:

Weitere Informationen