Freigeben über


ObjectParameterCollection.Add(ObjectParameter) Methode

Definition

Fügt der Auflistung den angegebenen ObjectParameter Wert 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 Parameter, der der Auflistung hinzugefügt werden soll.

Implementiert

Ausnahmen

Das parameter Argument ist null.

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

- oder -

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

Der Typ des Werts parameter ist ungültig.

Beispiele

In diesem Beispiel werden der Auflistung neue Parameter hinzugefügt. Er durchläuft den ObjectParameterCollection Namen, Typ und Wert jedes Parameters in der Auflistung und zeigt ihn an.

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

Nachdem Parameter hinzugefügt wurden, können sie aus der Auflistung entfernt werden, 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.

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

Gilt für:

Weitere Informationen