ObjectParameterCollection.Add(ObjectParameter) Methode

Definitie

Naamruimte:
System.Data.Objects
Assembly:
System.Data.Entity.dll

Voegt de opgegeven ObjectParameter waarde toe aan de verzameling.

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)

Parameters

parameter
ObjectParameter

De parameter die moet worden toegevoegd aan de verzameling.

Implementeringen

Add(T)

Uitzonderingen

ArgumentNullException

Het parameter argument is null.

ArgumentException

Het parameter argument bestaat al in de verzameling. Dit gedrag verschilt van die van de meeste verzamelingen die dubbele vermeldingen toestaan.

– of –

Er bestaat al een parameter met dezelfde naam als het parameter argument in de verzameling. Houd er rekening mee dat de zoekactie niet hoofdlettergevoelig is. Dit gedrag verschilt van die van de meeste verzamelingen en lijkt meer op die van een Dictionary<TKey,TValue>.

ArgumentOutOfRangeException

Het type is parameter ongeldig.

Voorbeelden

In dit voorbeeld worden nieuwe parameters toegevoegd aan de verzameling. Hiermee wordt de ObjectParameterCollection naam, het type en de waarde van elke parameter in de verzameling herhaald.

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

Opmerkingen

Nadat parameters zijn toegevoegd, kunnen ze worden verwijderd uit de verzameling en kan de verzameling worden gewist, zolang de query niet is gecompileerd of uitgevoerd. Parameternamen kunnen niet worden gewijzigd, maar waarden kunnen op elk gewenst moment worden gewijzigd.

Parameters moeten uniek zijn in de ObjectParameterCollection. Er kunnen geen twee parameters in de verzameling met dezelfde naam zijn. Zie Methoden voor opbouwfunctie voor query's voor meer informatie.

Van toepassing op

Zie ook