ObjectParameterCollection.Remove(ObjectParameter) ObjectParameterCollection.Remove(ObjectParameter) ObjectParameterCollection.Remove(ObjectParameter) ObjectParameterCollection.Remove(ObjectParameter) Method

Definition

Entfernt nach Verweis eine Instanz eines ObjectParameter aus der Auflistung, wenn dieses in der Auflistung vorhanden ist.Removes an instance of an ObjectParameter from the collection by reference if it exists in the collection.

public:
 virtual bool Remove(System::Data::Objects::ObjectParameter ^ parameter);
public bool Remove (System.Data.Objects.ObjectParameter parameter);
abstract member Remove : System.Data.Objects.ObjectParameter -> bool
override this.Remove : System.Data.Objects.ObjectParameter -> bool
Public Function Remove (parameter As ObjectParameter) As Boolean

Parameter

parameter
ObjectParameter ObjectParameter ObjectParameter ObjectParameter

Ein Objekt, das aus der Auflistung entfernt werden soll.An object to remove from the collection.

Gibt zurück

true, wenn das Parameterobjekt gefunden und aus der Collection entfernt wurde, andernfalls false.true if the parameter object was found and removed from the collection; otherwise, false.

Implementiert

Ausnahmen

Das parameter-Argument lautet null.The parameter argument is null.

Beispiele

Das Beispiel in diesem Thema basiert auf dem AdventureWorks Sales-Modell.The example in this topic is based on the AdventureWorks Sales Model. In diesem Beispiel werden der Auflistung zwei Parameter hinzugefügt und wieder entfernt.The example adds two parameters to the collection and then removes the parameters.

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 ObjectQuery's Parameters collection.
    contactQuery.Parameters.Add(new ObjectParameter("ln", "Adams"));
    contactQuery.Parameters.Add(new ObjectParameter("fn", "Frances"));

    ObjectParameterCollection objectParameterCollection =
        contactQuery.Parameters;
    Console.WriteLine("Count before Remove is called: {0}",
        objectParameterCollection.Count);

    ObjectParameter objectParameter = objectParameterCollection["ln"];

    // Remove the specified parameter from the collection.
    objectParameterCollection.Remove(objectParameter);
    Console.WriteLine("Count after Remove is called: {0}",
        objectParameterCollection.Count);
}
Using context As New AdventureWorksEntities()
    Dim queryString As String = "SELECT VALUE contact FROM AdventureWorksEntities.Contacts " & _
            " AS contact WHERE contact.LastName = @ln AND contact.FirstName = @fn"

    Dim contactQuery As New ObjectQuery(Of Contact)(queryString, context)

    ' Add parameters to the ObjectQuery's Parameters collection. 
    contactQuery.Parameters.Add(New ObjectParameter("ln", "Adams"))
    contactQuery.Parameters.Add(New ObjectParameter("fn", "Frances"))

    Dim objectParameterCollection As ObjectParameterCollection = contactQuery.Parameters
    Console.WriteLine("Count before Remove is called: {0}", objectParameterCollection.Count)

    Dim objectParameter As ObjectParameter = objectParameterCollection("ln")

    ' Remove the specified parameter from the collection. 
    objectParameterCollection.Remove(objectParameter)
    Console.WriteLine("Count after Remove is called: {0}", objectParameterCollection.Count)
End Using

Hinweise

Dies ist ein verweisbasierter Vergleich.This is a reference-based comparison. Dies bedeutet: Falls ein Abfrageparameterobjekt angegeben wird, der denselben Namen wie ein Parameterobjekt in der Auflistung enthält, wird der Parameter in der Auflistung nur dann entfernt, wenn es sich um dasselbe Objekt handelt.That is, if a query parameter object is specified that contains the same name as a parameter object in the collection, the parameter in the collection will only be removed if it is the same object. Um ein Objekt nach Name zu entfernen, verwenden Sie zunächst den Indexer, um die Parameterinstanz abzurufen, und entfernen diese dann mithilfe dieser Methode.To remove an object by name, first use the indexer to retrieve the parameter instance, then remove it by using this method.

Gilt für: