ObjectParameterCollection.Add(ObjectParameter) Метод

Определение

Пространство имен:
System.Data.Objects
Сборка:
System.Data.Entity.dll

Добавляет указанный ObjectParameter в коллекцию.

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
ObjectParameter

Параметр, добавляемый в коллекцию.

Реализации

Add(T)

Исключения

ArgumentNullException

Аргумент parameter имеет значение null.

ArgumentException

Аргумент parameter уже существует в коллекции. Это поведение отличается от большинства коллекций, разрешающих повторяющиеся записи.

–или–

Другой параметр с тем же именем, что parameter и аргумент, уже существует в коллекции. Обратите внимание, что поиск не учитывает регистр. Это поведение отличается от большинства коллекций и больше похоже на это Dictionary<TKey,TValue>.

ArgumentOutOfRangeException

Недопустимый parameter тип.

Примеры

В этом примере в коллекцию добавляются новые параметры. Он выполняет итерацию ObjectParameterCollection по имени, типу и значению каждого параметра в коллекции.

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

Комментарии

После добавления параметров их можно удалить из коллекции и удалить коллекцию, если запрос не был скомпилирован или выполнен. Имена параметров нельзя изменить, но значения можно изменить в любое время.

Параметры должны быть уникальными в объекте ObjectParameterCollection. В коллекции не может быть два параметра с одинаковым именем. Дополнительные сведения см. в разделе "Методы построителя запросов".

Применяется к

См. также раздел