ObjectParameterCollection.Add(ObjectParameter) Método

Definição

Espaço de Nomes:
System.Data.Objects
Assemblagem:
System.Data.Entity.dll

Adiciona o especificado ObjectParameter à 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 parameter argumento é null.

ArgumentException

O parameter argumento já existe na coleção. Este comportamento difere do da maioria das coleções que permitem entradas duplicadas.

-ou-

Outro parâmetro com o mesmo nome do parameter argumento já existe na coleção. Note que a pesquisa é indistinta a maiúsculas minúsculas. Este comportamento difere do da maioria das coleções, e assemelha-se mais 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 através de ObjectParameterCollection e apresenta o nome, tipo e 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);
    }
}

Observações

Após a adição dos parâmetros, estes podem ser removidos da coleção e esta pode ser limpa, desde que a consulta não tenha sido compilada ou executada. Os nomes dos parâmetros não podem ser alterados, mas os valores podem ser alterados a qualquer momento.

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

Aplica-se a

Ver também