ObjectParameterCollection.Add(ObjectParameter) Metoda

Definicja

Przestrzeń nazw:

System.Data.Objects

Zestaw:

System.Data.Entity.dll

Dodaje określony ObjectParameter element do kolekcji.

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 do dodania do kolekcji.

Implementuje

Add(T)

Wyjątki

ArgumentNullException

Argumentem parameter jest null.

ArgumentException

Argument parameter już istnieje w kolekcji. To zachowanie różni się od większości kolekcji, które zezwalają na zduplikowane wpisy.

-lub-

Inny parametr o takiej samej nazwie jak parameter argument już istnieje w kolekcji. Zwróć uwagę, że wyszukiwanie nie uwzględnia wielkości liter. To zachowanie różni się od większości kolekcji i jest bardziej podobne do tego w przypadku elementu Dictionary<TKey,TValue>.

ArgumentOutOfRangeException

Typ elementu parameter jest nieprawidłowy.

Przykłady

W tym przykładzie dodano nowe parametry do kolekcji. Iteruje po ObjectParameterCollection i wyświetla nazwę, typ i wartość każdego parametru w kolekcji.

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

Uwagi

Po dodaniu parametrów można je usunąć z kolekcji, a kolekcja może zostać wyczyszczone, o ile zapytanie nie zostało skompilowane lub wykonane. Nie można zmienić nazw parametrów, ale wartości można zmienić w dowolnym momencie.

Parametry muszą być unikatowe w elemecie ObjectParameterCollection. W kolekcji nie można mieć dwóch parametrów o tej samej nazwie. Aby uzyskać więcej informacji, zobacz Metody konstruktora zapytań.

Zobacz też

• Wykonywanie zapytań dotyczących danych jako obiektów i kształtowanie wyników (Entity Framework)