ObjectContext.GetObjectByKey(EntityKey) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengembalikan objek yang memiliki kunci entitas yang ditentukan.
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
Parameter
- key
- EntityKey
Kunci objek yang akan ditemukan.
Mengembalikan
Yang Object merupakan instans dari jenis entitas.
Pengecualian
Parameternya key
adalah null
.
Objek tidak ditemukan di ObjectStateManager sumber data atau .
Contoh
Contoh ini membuat EntityKey untuk entitas dari jenis yang diberikan lalu mengambil entitas berdasarkan kunci.
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());
}
}
Keterangan
GetObjectByKey mencoba mengambil objek yang memiliki yang ditentukan EntityKey dari ObjectStateManager. Jika objek saat ini tidak dimuat ke dalam konteks objek, kueri dijalankan dalam upaya untuk mengembalikan objek dari sumber data. Untuk informasi selengkapnya, lihat Kueri Objek.
GetObjectByKey ObjectNotFoundException memunculkan ketika objek tidak dapat ditemukan. Untuk menghindari penanganan pengecualian ini, gunakan metode .TryGetObjectByKey
Metode ini akan mengembalikan objek dalam status Deleted .
Kunci sementara tidak dapat digunakan untuk mengembalikan objek dari sumber data.