ObjectContext.GetObjectByKey(EntityKey) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Retourneert een object met de opgegeven entiteitssleutel.
public:
System::Object ^ GetObjectByKey(System::Data::EntityKey ^ key);
public object GetObjectByKey(System.Data.EntityKey key);
member this.GetObjectByKey : System.Data.EntityKey -> obj
Public Function GetObjectByKey (key As EntityKey) As Object
Parameters
- key
- EntityKey
De sleutel van het object dat moet worden gevonden.
Retouren
Een Object instantie van een entiteitstype.
Uitzonderingen
De key parameter is null.
Het object is niet gevonden in de ObjectStateManager of de gegevensbron.
Voorbeelden
In dit voorbeeld wordt een EntityKey voor een entiteit van het opgegeven type gemaakt en wordt vervolgens een entiteit op sleutel opgehaald.
using (AdventureWorksEntities context =
new AdventureWorksEntities())
{
try
{
// Define the entity key values.
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.
SalesOrderHeader order =
(SalesOrderHeader)context.GetObjectByKey(key);
Console.WriteLine("SalesOrderID: {0} Order Number: {1}",
order.SalesOrderID, order.SalesOrderNumber);
}
catch (ObjectNotFoundException ex)
{
Console.WriteLine(ex.ToString());
}
}
Opmerkingen
GetObjectByKey probeert een object op te halen dat is opgegeven EntityKey uit de ObjectStateManager. Als het object momenteel niet in de objectcontext is geladen, wordt een query uitgevoerd in een poging om het object uit de gegevensbron te retourneren. Zie Objectquery's voor meer informatie.
GetObjectByKey hiermee wordt een ObjectNotFoundException object gegenereerd wanneer het object niet kan worden gevonden. Gebruik in plaats daarvan de TryGetObjectByKey methode om te voorkomen dat deze uitzondering wordt verwerkt.
Met deze methode worden objecten in de Deleted status geretourneerd.
Een tijdelijke sleutel kan niet worden gebruikt om een object uit de gegevensbron te retourneren.