ObjectContext.TryGetObjectByKey(EntityKey, Object) 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:
 bool TryGetObjectByKey(System::Data::EntityKey ^ key, [Runtime::InteropServices::Out] System::Object ^ % value);

public bool TryGetObjectByKey(System.Data.EntityKey key, out object value);

member this.TryGetObjectByKey : System.Data.EntityKey * obj -> bool

Public Function TryGetObjectByKey (key As EntityKey, ByRef value As Object) As Boolean

Paramètres

key

EntityKey

Clé de l’objet à trouver.

value

Object

Lorsque cette méthode est retournée, contient l’objet.

Retours

Boolean

true si l’objet a été récupéré avec succès. falsesi la key valeur est temporaire, la connexion est ou l’est valuenullnull.

Exceptions

ArgumentException

Métadonnées incompatibles pour key.

ArgumentNullException

key a la valeur null.

Exemples

Cet exemple crée une EntityKey entité du type donné, puis tente de récupérer une entité par clé.

using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    Object entity = null;
    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.
    if (context.TryGetObjectByKey(key, out entity))
    {
        Console.WriteLine("The requested " + entity.GetType().FullName +
            " object was found");
    }
    else
    {
        Console.WriteLine("An object with this key " +
            "could not be found.");
    }
}

Remarques

TryGetObjectByKey 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.

Utilisez la TryGetObjectByKey méthode pour éviter de gérer le ObjectNotFoundException déclenché lorsque GetObjectByKey l’objet est introuvable.

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.

La méthode TryGetObjectByKey applique le modèle standard .NET TryParse pour la méthode GetObjectByKey, en retournant false lorsque le ObjectNotFoundException est intercepté.

Voir aussi

• Utilisation d’objets (Entity Framework)