ObjectParameterCollection.Add(ObjectParameter) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет указанный параметр 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
Параметр для добавления в коллекцию.
Реализации
Исключения
Аргумент parameter
имеет значение null
.
Аргумент parameter
уже присутствует в коллекции. Это условие отличается от большинства коллекций, в которых допускаются повторяющиеся записи.
-или-
В коллекции уже присутствует другой параметр с тем же именем, что и у аргумента parameter
. Учтите, что в поиске не учитывается регистр. Это условие отличается от большинства коллекции и близко к правилам словаря Dictionary<TKey,TValue>.
Недопустимый тип 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 должны быть уникальными. Коллекция не может содержать два параметра с одинаковыми именами. Дополнительные сведения см. в разделе Методы построителя запросов.