ObjectContext.TryGetObjectByKey(EntityKey, Object) Méthode

  • Référence

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 à rechercher.

value
Object

Lorsque cette méthode retourne, contient l'objet.

Retours

Boolean

true si l'objet a été récupéré avec succès. false si le paramètre key est temporaire, la connexion est null ou le paramètre value est null.

Exceptions

ArgumentException

Métadonnées incompatibles pour key.

ArgumentNullException

key a la valeur null.

Exemples

Cet exemple crée un EntityKey pour une 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 essaie de récupérer un objet qui a l'objet EntityKey spécifié à partir de l'objet ObjectStateManager. Si l'objet n'est pas chargé actuellement dans le contexte de l'objet, une requête est exécutée en vue de retourner l'objet à partir de la source de données. Pour plus d’informations, consultez Requêtes d’objet.

Utilisez la méthode TryGetObjectByKey pour éviter de gérer l'exception ObjectNotFoundException levée par GetObjectByKey lorsque l'objet est introuvable.

Cette méthode retourne des objets à l'état Deleted.

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

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

S’applique à

Voir aussi