ObjectParameterCollection.Add(ObjectParameter) Método

Definição

Namespace:

System.Data.Objects

Assembly:

System.Data.Entity.dll

Adiciona o ObjectParameter especificado à coleção.

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)

Parâmetros

parameter

ObjectParameter

O parâmetro a adicionar à coleção.

Implementações

Add(T)

Exceções

ArgumentNullException

O argumento parameter é null.

ArgumentException

O argumento parameter já existe na coleção. Esse comportamento é diferente da maioria das coleções que permitem entradas duplicadas.

- ou -

Outro parâmetro com o mesmo nome que o argumento parameter já existe na coleção. Observe que a pesquisa não diferencia maiúsculas de minúsculas. Esse comportamento é diferente daquele da maioria das coleções e é mais semelhante ao de um Dictionary<TKey,TValue>.

ArgumentOutOfRangeException

O tipo do parameter não é válido.

Exemplos

Este exemplo adiciona novos parâmetros à coleção. Ele itera pelo ObjectParameterCollection e exibe o nome, o tipo e o valor de cada parâmetro na coleção.

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

Comentários

Depois que os parâmetros forem adicionados, eles poderão ser removidos da coleção e a coleção poderá ser limpa, desde que a consulta não tenha sido compilada ou executada. Os nomes de parâmetro não podem ser alterados, mas os valores podem ser alterados a qualquer momento.

Os parâmetros devem ser exclusivos no ObjectParameterCollection. Não pode haver dois parâmetros na coleção com o mesmo nome. Para obter mais informações, consulte Métodos do Construtor de Consultas.

Confira também

• Consultando dados como objetos e moldando resultados (Entity Framework)