ObjectContext.TryGetObjectByKey(EntityKey, Object) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vrátí objekt, který má zadaný klíč entity.
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
Parametry
- key
- EntityKey
Klíč objektu, který se má najít.
- value
- Object
Když tato metoda vrátí, obsahuje objekt .
Návraty
true
pokud byl objekt úspěšně načten.
false
key
pokud je dočasný, připojení je null
nebo value
je null
.
Výjimky
Nekompatibilní metadata pro key
.
key
je null
.
Příklady
Tento příklad vytvoří EntityKey pro entitu daného typu a pak se pokusí načíst entitu podle klíče.
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.");
}
}
Poznámky
TryGetObjectByKey se pokusí načíst objekt, který má zadanou EntityKey hodnotu z objektu ObjectStateManager. Pokud objekt není aktuálně načten do kontextu objektu, spustí se dotaz ve snaze vrátit objekt ze zdroje dat. Další informace najdete v tématu Dotazy na objekty.
TryGetObjectByKey Pomocí metody se vyhnete zpracování objektu ObjectNotFoundException vyvolaným objektem GetObjectByKey , když se objekt nenajde.
Tato metoda vrátí objekty ve Deleted stavu .
Dočasný klíč nelze použít k vrácení objektu ze zdroje dat.
Metoda TryGetObjectByKey použije standardní vzor rozhraní .NET TryParse
pro metodu GetObjectByKey , která false
se vrátí, když je zachycena ObjectNotFoundException .