ObjectContext.GetObjectByKey(EntityKey) Methode

Definitie

Retourneert een object met de opgegeven entiteitssleutel.

public:
 System::Object ^ GetObjectByKey(System::Data::EntityKey ^ key);
public object GetObjectByKey(System.Data.EntityKey key);
member this.GetObjectByKey : System.Data.EntityKey -> obj
Public Function GetObjectByKey (key As EntityKey) As Object

Parameters

key
EntityKey

De sleutel van het object dat moet worden gevonden.

Retouren

Een Object instantie van een entiteitstype.

Uitzonderingen

De key parameter is null.

Het object is niet gevonden in de ObjectStateManager of de gegevensbron.

Voorbeelden

In dit voorbeeld wordt een EntityKey voor een entiteit van het opgegeven type gemaakt en wordt vervolgens een entiteit op sleutel opgehaald.

using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    try
    {
        // Define the entity key values.
        IEnumerable<KeyValuePair<string, object>> entityKeyValues =
            new KeyValuePair<string, object>[] {
            new KeyValuePair<string, object>("SalesOrderID", 43680) };

        // Create the  key for a specific SalesOrderHeader object.
        EntityKey key = new EntityKey("AdventureWorksEntities.SalesOrderHeaders", entityKeyValues);

        // Get the object from the context or the persisted store by its key.
        SalesOrderHeader order =
            (SalesOrderHeader)context.GetObjectByKey(key);

        Console.WriteLine("SalesOrderID: {0} Order Number: {1}",
            order.SalesOrderID, order.SalesOrderNumber);
    }
    catch (ObjectNotFoundException ex)
    {
        Console.WriteLine(ex.ToString());
    }
}

Opmerkingen

GetObjectByKey probeert een object op te halen dat is opgegeven EntityKey uit de ObjectStateManager. Als het object momenteel niet in de objectcontext is geladen, wordt een query uitgevoerd in een poging om het object uit de gegevensbron te retourneren. Zie Objectquery's voor meer informatie.

GetObjectByKey hiermee wordt een ObjectNotFoundException object gegenereerd wanneer het object niet kan worden gevonden. Gebruik in plaats daarvan de TryGetObjectByKey methode om te voorkomen dat deze uitzondering wordt verwerkt.

Met deze methode worden objecten in de Deleted status geretourneerd.

Een tijdelijke sleutel kan niet worden gebruikt om een object uit de gegevensbron te retourneren.

Van toepassing op

Zie ook