ObjectContext.TryGetObjectByKey(EntityKey, Object) Méthode

Référence

Définition

Espace de noms:: System.Data.Objects

Assembly:: System.Data.Entity.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

Utilisation des objets (Entity Framework)

Partager via