ObjectParameterCollection.Add(ObjectParameter) Metodo

Definizione

Spazio dei nomi:

System.Data.Objects

Assembly:

System.Data.Entity.dll

Aggiunge l'oggetto ObjectParameter specificato alla raccolta.

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)

Parametri

parameter

ObjectParameter

Parametro da aggiungere alla raccolta.

Implementazioni

Add(T)

Eccezioni

ArgumentNullException

Il valore dell'argomento parameter è null.

ArgumentException

L'argomento parameter esiste già nell'insieme. Questo comportamento è diverso da quello previsto per la maggior parte delle raccolte che consentono voci duplicate.

-oppure-

Un altro parametro con lo stesso nome dell'argomento parameter esiste già nell'insieme. Notare che la ricerca viene eseguita senza distinzione tra maiuscole e minuscole. Questo comportamento è diverso da quello previsto per la maggior parte delle raccolte ed è più simile al comportamento di un oggetto Dictionary<TKey,TValue>.

ArgumentOutOfRangeException

Il tipo di parameter non è valido.

Esempio

In questo esempio vengono aggiunti nuovi parametri alla raccolta. Viene scorso l'oggetto ObjectParameterCollection e vengono visualizzati il nome, il tipo e il valore di ogni parametro nella raccolta.

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

Commenti

Dopo essere stati aggiunti, i parametri possono essere rimossi dalla raccolta e la raccolta può essere cancellata, a condizione che la query non sia stata compilata o eseguita. I nomi dei parametri non possono essere modificati, ma è possibile cambiare i valori in qualsiasi momento.

I parametri devono essere univoci in ObjectParameterCollection. Nella raccolta non possono essere presenti due parametri con lo stesso nome. Per altre informazioni, vedere Metodi del generatore di query.

Vedi anche

• Esecuzione di query sui dati come oggetti e data shaping (Entity Framework)