ObjectParameterCollection.Add(ObjectParameter) Méthode

Définition

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

Ajoute le paramètre spécifié ObjectParameter à 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 est 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 en double.

- 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 est plus semblable à celui d’un Dictionary<TKey,TValue>.

ArgumentOutOfRangeException

Le type du fichier parameter n’est pas valide.

Exemples

Cet exemple ajoute de nouveaux paramètres à la collection. Il effectue une itération au sein de la ObjectParameterCollection collection 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 les paramètres ajoutés, ils 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 de paramètres ne peuvent pas être modifiés, mais les valeurs peuvent être modifiées à tout moment.

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

S’applique à

Voir aussi