ObjectContext.GetObjectByKey(EntityKey) Méthode

Définition

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

Retourne un objet qui a la clé d’entité spécifiée.

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

Paramètres

key
EntityKey

Clé de l’objet à trouver.

Retours

Object

Instance Object d’un type d’entité.

Exceptions

ArgumentNullException

Le key paramètre est null.

ObjectNotFoundException

L’objet est introuvable dans la ObjectStateManager source de données ou la source de données.

Exemples

Cet exemple crée une EntityKey entité du type donné, puis extrait une entité par clé.

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

Remarques

GetObjectByKey tente de récupérer un objet qui a la valeur spécifiée EntityKey à partir du ObjectStateManager. Si l’objet n’est actuellement pas chargé dans le contexte de l’objet, une requête est exécutée dans une tentative de retour de l’objet à partir de la source de données.

GetObjectByKey déclenche une ObjectNotFoundException requête lorsque l’objet est introuvable. Pour éviter de gérer cette exception, utilisez plutôt la TryGetObjectByKey méthode.

Cette méthode retourne des objets dans l’état Deleted .

Une clé temporaire ne peut pas être utilisée pour renvoyer un objet à partir de la source de données.

S’applique à

Voir aussi