ObjectContext Kelas

Referensi

Definisi

Ruang nama:: System.Data.Objects

Rakitan:: System.Data.Entity.dll

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.

Menyediakan fasilitas untuk mengkueri dan bekerja dengan data entitas sebagai objek.

public ref class ObjectContext : IDisposable

public class ObjectContext : IDisposable

type ObjectContext = class
    interface IDisposable

Public Class ObjectContext
Implements IDisposable

Warisan: Object
ObjectContext

Penerapan: IDisposable

Contoh

Contoh ini menunjukkan kepada Anda cara membuat ObjectContext.

// Create the ObjectContext.
ObjectContext context =
    new ObjectContext("name=AdventureWorksEntities");

// Set the DefaultContainerName for the ObjectContext.
// When DefaultContainerName is set, the Entity Framework only
// searches for the type in the specified container.
// Note that if a type is defined only once in the metadata workspace
// you do not have to set the DefaultContainerName.
context.DefaultContainerName = "AdventureWorksEntities";

ObjectSet<Product> query = context.CreateObjectSet<Product>();

// Iterate through the collection of Products.
foreach (Product result in query)
    Console.WriteLine("Product Name: {0}", result.Name);

Keterangan

Catatan

Kelas ObjectContext ini tidak aman untuk utas. Integritas objek data dalam tidak dapat dipastikan ObjectContext dalam skenario multithreaded.

Kelas ObjectContext adalah kelas utama untuk berinteraksi dengan data sebagai objek yang merupakan instans jenis entitas yang ditentukan dalam model konseptual. Instans ObjectContext kelas merangkum hal-hal berikut:

Koneksi ke database, dalam bentuk EntityConnection objek.
Metadata yang menjelaskan model, dalam bentuk MetadataWorkspace objek.
Objek ObjectStateManager yang mengelola objek tetap ada di cache.

Ketika lapisan objek yang mewakili model konseptual dihasilkan oleh alat Model Data Entitas, kelas yang mewakili EntityContainer untuk model berasal dari ObjectContext.

Konstruktor

ObjectContext(EntityConnection)	Menginisialisasi instans ObjectContext baru kelas dengan koneksi yang diberikan. Selama konstruksi, ruang kerja metadata diekstrak dari EntityConnection objek .
ObjectContext(EntityConnection, String)	Menginisialisasi instans ObjectContext baru kelas dengan nama kontainer koneksi dan entitas tertentu.
ObjectContext(String)	Menginisialisasi instans ObjectContext baru kelas dengan string koneksi dan nama kontainer entitas default yang diberikan.
ObjectContext(String, String)	Menginisialisasi instans ObjectContext baru kelas dengan nama kontainer string koneksi dan entitas tertentu.

Properti

CommandTimeout	Mendapatkan atau mengatur nilai batas waktu, dalam detik, untuk semua operasi konteks objek. `null` Nilai menunjukkan bahwa nilai default penyedia yang mendasar akan digunakan.
Connection	Mendapatkan koneksi yang digunakan oleh konteks objek.
ContextOptions	Mendapatkan instans ObjectContextOptions yang berisi opsi yang memengaruhi perilaku ObjectContext.
DefaultContainerName	Mendapatkan atau mengatur nama kontainer default.
MetadataWorkspace	Mendapatkan ruang kerja metadata yang digunakan oleh konteks objek.
ObjectStateManager	Mendapatkan manajer status objek yang digunakan oleh konteks objek untuk melacak perubahan objek.
QueryProvider	Mendapatkan penyedia kueri LINQ yang terkait dengan konteks objek ini.

Metode

AcceptAllChanges()	Menerima semua perubahan yang dilakukan pada objek dalam konteks objek.
AddObject(String, Object)	Menambahkan objek ke konteks objek.
ApplyCurrentValues<TEntity>(String, TEntity)	Menyalin nilai skalar dari objek yang disediakan ke dalam objek di ObjectContext yang memiliki kunci yang sama.
ApplyOriginalValues<TEntity>(String, TEntity)	Menyalin nilai skalar dari objek yang disediakan ke dalam sekumpulan nilai asli untuk objek dalam ObjectContext yang memiliki kunci yang sama.
ApplyPropertyChanges(String, Object)	Kedaluwarsa. Menerapkan perubahan properti dari objek yang dilepas ke objek yang sudah dilampirkan ke konteks objek.
Attach(IEntityWithKey)	Melampirkan grafik objek atau objek ke konteks objek saat objek memiliki kunci entitas.
AttachTo(String, Object)	Melampirkan grafik objek atau objek ke konteks objek dalam kumpulan entitas tertentu.
CreateDatabase()	Membuat database dengan menggunakan koneksi sumber data saat ini dan metadata di StoreItemCollection.
CreateDatabaseScript()	Menghasilkan skrip bahasa definisi data (DDL) yang membuat objek skema (tabel, kunci primer, kunci asing) untuk metadata di StoreItemCollection. Memuat StoreItemCollection metadata dari file bahasa definisi skema (SSDL) penyimpanan.
CreateEntityKey(String, Object)	Membuat kunci entitas untuk objek tertentu, atau mengembalikan kunci entitas jika sudah ada.
CreateObject<T>()	Membuat dan mengembalikan instans dari jenis yang diminta .
CreateObjectSet<TEntity>()	Membuat instans baru ObjectSet<TEntity> yang digunakan untuk mengkueri, menambahkan, memodifikasi, dan menghapus objek dari jenis entitas yang ditentukan.
CreateObjectSet<TEntity>(String)	Membuat instans baru ObjectSet<TEntity> yang digunakan untuk mengkueri, menambahkan, memodifikasi, dan menghapus objek dari jenis yang ditentukan dan dengan nama kumpulan entitas yang ditentukan.
CreateProxyTypes(IEnumerable<Type>)	Menghasilkan jenis yang setara yang dapat digunakan dengan Kerangka Kerja Entitas untuk setiap jenis dalam enumerasi yang disediakan.
CreateQuery<T>(String, ObjectParameter[])	ObjectQuery<T> Membuat dalam konteks objek saat ini dengan menggunakan string kueri yang ditentukan.
DatabaseExists()	Memeriksa apakah database yang ditentukan sebagai database dalam koneksi sumber data saat ini ada di sumber data.
DeleteDatabase()	Menghapus database yang ditentukan sebagai database dalam koneksi sumber data saat ini.
DeleteObject(Object)	Menandai objek untuk dihapus.
Detach(Object)	Menghapus objek dari konteks objek.
DetectChanges()	Memastikan bahwa ObjectStateEntry perubahan disinkronkan dengan perubahan di semua objek yang dilacak oleh ObjectStateManager.
Dispose()	Melepaskan sumber daya yang digunakan oleh konteks objek.
Dispose(Boolean)	Melepaskan sumber daya yang digunakan oleh konteks objek.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
ExecuteFunction(String, ObjectParameter[])	Menjalankan prosedur atau fungsi tersimpan yang ditentukan dalam sumber data dan dinyatakan dalam model konseptual; membuang hasil apa pun yang dikembalikan dari fungsi; dan mengembalikan jumlah baris yang terpengaruh oleh eksekusi.
ExecuteFunction<TElement>(String, MergeOption, ObjectParameter[])	Menjalankan prosedur atau fungsi tersimpan yang diberikan yang ditentukan dalam sumber data dan dinyatakan dalam model konseptual, dengan parameter yang ditentukan, dan opsi gabungkan. Mengembalikan tipe ObjectResult<T>.
ExecuteFunction<TElement>(String, ObjectParameter[])	Menjalankan prosedur atau fungsi tersimpan yang ditentukan dalam sumber data dan dipetakan dalam model konseptual, dengan parameter yang ditentukan. Mengembalikan tipe ObjectResult<T>.
ExecuteStoreCommand(String, Object[])	Menjalankan perintah arbitrer langsung terhadap sumber data menggunakan koneksi yang ada.
ExecuteStoreQuery<TElement>(String, Object[])	Menjalankan kueri secara langsung terhadap sumber data yang mengembalikan urutan hasil yang ditik.
ExecuteStoreQuery<TEntity>(String, String, MergeOption, Object[])	Menjalankan kueri secara langsung terhadap sumber data dan mengembalikan urutan hasil yang ditik. Tentukan kumpulan entitas dan opsi gabungkan sehingga hasil kueri dapat dilacak sebagai entitas.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetKnownProxyTypes()	Mengembalikan semua jenis proksi yang ada.
GetObjectByKey(EntityKey)	Mengembalikan objek yang memiliki kunci entitas yang ditentukan.
GetObjectType(Type)	Mengembalikan jenis entitas entitas POCO yang terkait dengan objek proksi dari jenis tertentu.
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
LoadProperty(Object, String)	Secara eksplisit memuat objek yang terkait dengan objek yang disediakan oleh properti navigasi yang ditentukan dan menggunakan opsi penggabungan default.
LoadProperty(Object, String, MergeOption)	Secara eksplisit memuat objek yang terkait dengan objek yang disediakan oleh properti navigasi yang ditentukan dan menggunakan opsi penggabungan yang ditentukan.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>)	Secara eksplisit memuat objek yang terkait dengan objek yang disediakan oleh kueri LINQ yang ditentukan dan dengan menggunakan opsi penggabungan default.
LoadProperty<TEntity>(TEntity, Expression<Func<TEntity,Object>>, MergeOption)	Secara eksplisit memuat objek yang terkait dengan objek yang disediakan oleh kueri LINQ yang ditentukan dan dengan menggunakan opsi penggabungan yang ditentukan.
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
Refresh(RefreshMode, IEnumerable)	Updates kumpulan objek dalam konteks objek dengan data dari sumber data.
Refresh(RefreshMode, Object)	Updates objek dalam konteks objek dengan data dari sumber data.
SaveChanges()	Mempertahankan semua pembaruan pada sumber data dan mengatur ulang pelacakan perubahan dalam konteks objek.
SaveChanges(Boolean)	Kedaluwarsa. Mempertahankan semua pembaruan pada sumber data dan secara opsional mengatur ulang pelacakan perubahan dalam konteks objek.
SaveChanges(SaveOptions)	Mempertahankan semua pembaruan pada sumber data dengan yang ditentukan SaveOptions.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
Translate<TElement>(DbDataReader)	Menerjemahkan DbDataReader yang berisi baris data entitas ke objek dari jenis entitas yang diminta.
Translate<TEntity>(DbDataReader, String, MergeOption)	Menerjemahkan DbDataReader yang berisi baris data entitas ke objek dari jenis entitas yang diminta, dalam set entitas tertentu, dan dengan opsi penggabungan yang ditentukan.
TryGetObjectByKey(EntityKey, Object)	Mengembalikan objek yang memiliki kunci entitas yang ditentukan.

Acara

ObjectMaterialized	Terjadi ketika objek entitas baru dibuat dari data di sumber data sebagai bagian dari operasi kueri atau beban.
SavingChanges	Terjadi ketika perubahan disimpan ke sumber data.

Berlaku untuk