DataServiceContext Kelas

Definisi

Ruang nama:

System.Data.Services.Client

Rakitan:

System.Data.Services.Client.dll

DataServiceContext mewakili konteks runtime layanan data.

public ref class DataServiceContext

public class DataServiceContext

type DataServiceContext = class

Public Class DataServiceContext

Warisan

Object

DataServiceContext

Contoh

Contoh berikut menunjukkan cara menggunakan DataServiceContext yang dihasilkan oleh alat Tambahkan Referensi Layanan untuk menjalankan kueri secara implisit terhadap layanan data Northwind yang mengembalikan semua pelanggan. URI dari kumpulan entitas yang diminta Customers ditentukan secara otomatis oleh konteks. Kueri dijalankan secara implisit ketika enumerasi terjadi. Layanan data Northwind dibuat saat Anda menyelesaikan Layanan Data WCF .

// Create the DataServiceContext using the service URI.
NorthwindEntities context = new NorthwindEntities(svcUri);

// Define a new query for Customers.
DataServiceQuery<Customer> query = context.Customers;

try
{
    // Enumerate over the query result, which is executed implicitly.
    foreach (Customer customer in query)
    {
        Console.WriteLine("Customer Name: {0}", customer.CompanyName);
    }
}
catch (DataServiceQueryException ex)
{
    throw new ApplicationException(
        "An error occurred during query execution.", ex);
}

' Create the DataServiceContext using the service URI.
Dim context = New NorthwindEntities(svcUri)

' Define a new query for Customers.
Dim query As DataServiceQuery(Of Customer) = context.Customers

Try
    ' Enumerate over the query result, which is executed implicitly.
    For Each customer As Customer In query
        Console.WriteLine("Customer Name: {0}", customer.CompanyName)
    Next
Catch ex As DataServiceQueryException
    Throw New ApplicationException(
            "An error occurred during query execution.", ex)
End Try

Keterangan

Layanan Data WCF tidak memiliki status DataServiceContext , tetapi tidak. Status pada klien dipertahankan di antara interaksi untuk mendukung fitur seperti manajemen pembaruan. Kelas ini, dan DataServiceQuery kelas yang mewakili permintaan HTTP tertentu ke layanan data, adalah dua kelas utama di pustaka klien.

Konstruktor

Nama	Deskripsi
DataServiceContext(Uri)	Menginisialisasi instans DataServiceContext baru kelas dengan yang ditentukan serviceRoot.

Properti

Nama	Deskripsi
ApplyingChanges	Mendapatkan nilai yang menunjukkan apakah DataServiceContext saat ini menerapkan perubahan pada objek terlacak.
BaseUri	Mendapatkan URI absolut yang mengidentifikasi akar layanan data target.
Credentials	Mendapatkan atau mengatur informasi autentikasi yang digunakan oleh setiap kueri yang dibuat dengan menggunakan DataServiceContext objek .
DataNamespace	Mendapatkan atau mengatur namespace XML untuk item data, bukan item metadata, dari payload Atom.
Entities	Mendapatkan daftar semua sumber daya yang saat ini sedang dilacak oleh DataServiceContext.
IgnoreMissingProperties	Mendapatkan atau mengatur apakah properti yang dibaca dari jenis harus dipetakan ke properti pada jenis sisi klien.
IgnoreResourceNotFoundException	Mendapatkan atau mengatur apakah pengecualian dimunculkan ketika kesalahan 404 (sumber daya tidak ditemukan) dikembalikan oleh layanan data.
Links	Mendapatkan koleksi semua asosiasi atau tautan yang saat ini sedang dilacak oleh DataServiceContext objek.
MergeOption	Mendapatkan atau mengatur opsi sinkronisasi untuk menerima entitas dari layanan data.
ResolveName	Mendapatkan atau mengatur fungsi untuk mengambil alih strategi resolusi jenis default yang digunakan oleh pustaka klien saat Anda mengirim entitas ke layanan data.
ResolveType	Mendapatkan atau mengatur fungsi yang digunakan untuk mengambil alih opsi resolusi jenis default yang digunakan oleh pustaka klien saat menerima entitas dari layanan data.
SaveChangesDefaultOptions	Mendapatkan atau mengatur SaveChangesOptions nilai yang digunakan oleh SaveChanges() metode .
Timeout	Mendapatkan atau mengatur opsi waktu habis yang digunakan untuk permintaan HTTP yang mendasar ke layanan data.
TypeScheme	Mendapatkan atau mengatur URI yang digunakan untuk menunjukkan skema jenis apa yang digunakan oleh layanan.
UsePostTunneling	Mendapatkan atau menetapkan nilai Boolean yang menunjukkan apakah akan menggunakan penerowongan pasca.

Metode

Nama	Deskripsi
AddLink(Object, String, Object)	Menambahkan tautan yang ditentukan ke kumpulan objek pelacakan DataServiceContext .
AddObject(String, Object)	Menambahkan objek yang ditentukan ke kumpulan objek yang sedang dilacak DataServiceContext .
AddRelatedObject(Object, String, Object)	Menambahkan objek terkait ke konteks dan membuat tautan yang menentukan hubungan antara dua objek dalam satu permintaan.
AttachLink(Object, String, Object)	Memberi tahu DataServiceContext untuk mulai melacak tautan yang ditentukan yang menentukan hubungan antara objek entitas.
AttachTo(String, Object, String)	Memberi tahu DataServiceContext untuk mulai melacak sumber daya yang ditentukan dan menyediakan lokasi sumber daya dalam set sumber daya yang ditentukan.
AttachTo(String, Object)	Memberi tahu DataServiceContext untuk mulai melacak sumber daya yang ditentukan dan menyediakan lokasi sumber daya dalam set sumber daya yang ditentukan.
BeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)	Secara asinkron mengirim permintaan ke layanan data untuk mengambil halaman data berikutnya dalam hasil kueri berhadiah.
BeginExecute<TElement>(Uri, AsyncCallback, Object)	Secara asinkron mengirim permintaan sehingga panggilan ini tidak memblokir pemrosesan saat menunggu hasil dari layanan.
BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[])	Secara asinkron mengirimkan sekelompok kueri sebagai batch ke layanan data.
BeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object)	Secara asinkron mendapatkan data properti biner untuk entitas yang ditentukan sebagai aliran data bersama dengan header pesan yang ditentukan.
BeginLoadProperty(Object, String, AsyncCallback, Object)	Secara asinkron memuat nilai properti yang ditentukan dari layanan data.
BeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object)	Secara asinkron memuat halaman berikutnya dari entitas terkait dari layanan data dengan menggunakan objek kelanjutan kueri yang disediakan.
BeginLoadProperty(Object, String, Uri, AsyncCallback, Object)	Secara asinkron memuat halaman entitas terkait dari layanan data dengan menggunakan URI tautan berikutnya yang disediakan.
BeginSaveChanges(AsyncCallback, Object)	Secara asinkron mengirimkan perubahan yang tertunda ke layanan data yang DataServiceContext dikumpulkan sejak terakhir kali perubahan disimpan.
BeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)	Secara asinkron mengirimkan perubahan yang tertunda ke layanan data yang DataServiceContext dikumpulkan sejak terakhir kali perubahan disimpan.
CancelRequest(IAsyncResult)	Upaya untuk membatalkan operasi yang terkait dengan objek yang disediakan IAsyncResult .
CreateQuery<T>(String)	Membuat kueri layanan data untuk data dari jenis generik tertentu.
DeleteLink(Object, String, Object)	Mengubah status tautan menjadi dihapus dalam daftar tautan yang sedang dilacak oleh DataServiceContext.
DeleteObject(Object)	Mengubah status objek yang ditentukan untuk dihapus di DataServiceContext.
Detach(Object)	Menghapus entitas dari daftar entitas yang sedang dilacak DataServiceContext .
DetachLink(Object, String, Object)	Menghapus tautan yang ditentukan dari daftar tautan yang sedang dilacak oleh DataServiceContext.
EndExecute<TElement>(IAsyncResult)	Dipanggil untuk menyelesaikan BeginExecute<TElement>(Uri, AsyncCallback, Object).
EndExecuteBatch(IAsyncResult)	Dipanggil untuk menyelesaikan BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[]).
EndGetReadStream(IAsyncResult)	Dipanggil untuk menyelesaikan operasi asinkron untuk mengambil properti biner sebagai aliran.
EndLoadProperty(IAsyncResult)	Dipanggil untuk menyelesaikan BeginLoadProperty(Object, String, AsyncCallback, Object) operasi.
EndSaveChanges(IAsyncResult)	Dipanggil untuk menyelesaikan BeginSaveChanges(AsyncCallback, Object) operasi.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Execute<T>(DataServiceQueryContinuation<T>)	Mengirim permintaan ke layanan data untuk mengambil halaman data berikutnya dalam hasil kueri berhala.
Execute<TElement>(Uri)	Mengirim permintaan ke layanan data untuk menjalankan URI tertentu.
ExecuteBatch(DataServiceRequest[])	Mengirimkan sekelompok kueri sebagai batch ke layanan data.
GetEntityDescriptor(Object)	Mendapatkan untuk objek entitas yang EntityDescriptor disediakan.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLinkDescriptor(Object, String, Object)	LinkDescriptor Mendapatkan untuk tautan tertentu yang menentukan hubungan antara dua entitas.
GetMetadataUri()	Mendapatkan URI lokasi metadata .edmx.
GetReadStream(Object, DataServiceRequestArgs)	Mendapatkan data properti biner untuk entitas yang ditentukan sebagai aliran data bersama dengan header pesan yang ditentukan.
GetReadStream(Object, String)	Mendapatkan data properti biner untuk entitas yang ditentukan sebagai aliran data, dengan header pesan Terima yang ditentukan.
GetReadStream(Object)	Mendapatkan data properti biner untuk entitas yang ditentukan sebagai aliran data.
GetReadStreamUri(Object)	Mendapatkan URI yang digunakan untuk mengembalikan data properti biner sebagai aliran data.
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
LoadProperty(Object, String, DataServiceQueryContinuation)	Memuat halaman entitas terkait berikutnya dari layanan data dengan menggunakan objek kelanjutan kueri yang disediakan.
LoadProperty(Object, String, Uri)	Memuat halaman entitas terkait dengan menggunakan URI tautan berikutnya yang disediakan.
LoadProperty(Object, String)	Memuat konten yang ditangguhkan untuk properti tertentu dari layanan data.
LoadProperty<T>(Object, String, DataServiceQueryContinuation<T>)	Memuat halaman entitas terkait berikutnya dari layanan data dengan menggunakan objek kelanjutan kueri generik yang disediakan.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
SaveChanges()	Menyimpan perubahan yang sedang dilacak DataServiceContext ke penyimpanan.
SaveChanges(SaveChangesOptions)	Menyimpan perubahan yang sedang dilacak DataServiceContext ke penyimpanan.
SetLink(Object, String, Object)	Memberi tahu DataServiceContext bahwa tautan baru ada di antara objek yang ditentukan dan bahwa tautan diwakili oleh properti yang ditentukan oleh sourceProperty parameter .
SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)	Mengatur aliran data baru sebagai properti biner entitas, dengan pengaturan yang ditentukan dalam pesan permintaan.
SetSaveStream(Object, Stream, Boolean, String, String)	Mengatur aliran data baru sebagai properti biner entitas. Header Tipe Konten dan Simpul yang ditentukan disertakan dalam pesan permintaan.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
TryGetEntity<TEntity>(Uri, TEntity)	Uji pengambilan entitas yang sedang dilacak oleh DataServiceContext referensi ke URI entitas.
TryGetUri(Object, Uri)	Mengambil URI kanonis yang terkait dengan entitas yang ditentukan, jika tersedia.
UpdateObject(Object)	Mengubah status objek yang ditentukan di ke DataServiceContextModified.

Acara

Nama	Deskripsi
ReadingEntity	Terjadi setelah data entitas benar-benar dibaca ke dalam objek entitas.
SendingRequest	Terjadi ketika baru HttpWebRequest telah dibuat.
WritingEntity	Terjadi setelah entitas diserialisasikan sepenuhnya ke XML dalam pesan permintaan.

Lihat juga

• Kerja dengan .NET Framework Client Libraries (WCF Data Services)