ObjectParameterCollection.Add(ObjectParameter) Méthode

  • Référence

Définition

Espace de noms:
System.Data.Objects
Assembly:
System.Data.Entity.dll

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