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

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. Pour plus d’informations, consultez Requêtes d’objet.

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

S’applique à

Voir aussi