ObjectParameterCollection.Add(ObjectParameter) Metodo

Definizione

Spazio dei nomi:
System.Data.Objects
Assembly:
System.Data.Entity.dll

Aggiunge l'oggetto specificato ObjectParameter all'insieme.

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

L'argomento parameter è null.

ArgumentException

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

oppure

Un altro parametro con lo stesso nome dell'argomento parameter esiste già nella raccolta. Si noti che la ricerca non fa distinzione tra maiuscole e minuscole. Questo comportamento è diverso da quello della maggior parte delle raccolte ed è più simile a quello di un oggetto Dictionary<TKey,TValue>.

ArgumentOutOfRangeException

Il tipo di parameter non è valido.

Esempio

In questo esempio vengono aggiunti nuovi parametri alla raccolta. Scorre ObjectParameterCollection e visualizza 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 aver aggiunto i parametri, possono essere rimossi dalla raccolta e la raccolta può essere cancellata, purché la query non sia stata compilata o eseguita. I nomi dei parametri non possono essere modificati, ma i valori possono essere modificati 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 di Generatore query.

Si applica a

Vedi anche