ObjectParameterCollection.Add(ObjectParameter) Méthode

Référence

Définition

Espace de noms:: System.Data.Objects

Assembly:: System.Data.Entity.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Ajoute l'objet ObjectParameter spécifié à la collection.

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)

Paramètres

parameter: ObjectParameter

Paramètre à ajouter à la collection.

Implémente

Add(T)

Exceptions

ArgumentNullException

L'argument parameter a la valeur null.

ArgumentException

L'argument parameter existe déjà dans la collection. Ce comportement diffère de celui de la plupart des collections qui autorisent les entrées dupliquées.

- ou -

Un autre paramètre portant le même nom que l'argument parameter existe déjà dans la collection. Notez que la recherche ne respecte pas la casse. Ce comportement diffère de celui de la plupart des collections et ressemble davantage à celui d’un objet Dictionary<TKey,TValue>.

ArgumentOutOfRangeException

Le type du parameter n'est pas valide.

Exemples

Cet exemple ajoute de nouveaux paramètres à la collection. Il itère au sein de la collection ObjectParameterCollection et affiche le nom, le type et la valeur de chaque paramètre de la collection.

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

Remarques

Une fois ajoutés, les paramètres peuvent être supprimés de la collection et la collection peut être effacée, tant que la requête n’a pas été compilée ou exécutée. Les noms des paramètres ne peuvent pas être modifiés, mais leurs valeurs peuvent l'être à tout moment.

Les paramètres doivent être uniques dans la collection ObjectParameterCollection. Une même collection ne peut pas contenir deux paramètres du même nom. Pour plus d’informations, consultez Méthodes du Générateur de requêtes.

S’applique à

Voir aussi

Interrogation de données en tant qu’objets et mise en forme des résultats (Entity Framework)

Partager via