ObjectContext.GetObjectByKey(EntityKey) Metódus

Definíció

Névtér:
System.Data.Objects
Szerelvény:
System.Data.Entity.dll

A megadott entitáskulcsot tartalmazó objektumot ad vissza.

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

Paraméterek

key
EntityKey

A megtalálandó objektum kulcsa.

Válaszok

Object

Egy Object entitástípus egy példánya.

Kivételek

ArgumentNullException

A key paraméter a következő null: .

ObjectNotFoundException

Az objektum nem található sem az adatforrásban, sem az ObjectStateManager adatforrásban.

Példák

Ez a példa létrehoz egy EntityKey adott típusú entitást, majd kulcs alapján lekéri az entitást.

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());
    }
}

Megjegyzések

GetObjectByKey megpróbál lekérni egy objektumot, amely a megadott EntityKey a ObjectStateManager. Ha az objektum jelenleg nincs betöltve az objektumkörnyezetbe, a rendszer lekérdezést hajt végre, hogy megpróbálja visszaadni az objektumot az adatforrásból. További információ: Objektum-lekérdezések.

GetObjectByKey ObjectNotFoundException ekkor az objektum nem található. A kivétel kezelésének elkerülése érdekében használja inkább a metódust TryGetObjectByKey .

Ez a metódus az állapotban lévő Deleted objektumokat adja vissza.

Ideiglenes kulcs nem használható objektum adatforrásból való visszaadására.

A következőre érvényes:

Lásd még