DataServiceContext.AttachTo Metode

Definisi

Ruang nama:

System.Data.Services.Client

Rakitan:

System.Data.Services.Client.dll

Memberi tahu DataServiceContext untuk mulai melacak sumber daya yang ditentukan dan menyediakan lokasi sumber daya dalam set sumber daya yang ditentukan.

Overload

AttachTo(String, Object)	Memberi tahu DataServiceContext untuk mulai melacak sumber daya yang ditentukan dan menyediakan lokasi sumber daya dalam set sumber daya yang ditentukan.
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.

public:
 void AttachTo(System::String ^ entitySetName, System::Object ^ entity);

public void AttachTo (string entitySetName, object entity);

member this.AttachTo : string * obj -> unit

Public Sub AttachTo (entitySetName As String, entity As Object)

Parameter

entitySetName

String

Nama set yang berisi sumber daya.

entity

Object

Sumber daya yang akan dilacak oleh DataServiceContext. Sumber daya dilampirkan dalam status Tidak Berubah.

Pengecualian

ArgumentNullException

entity atau entitySetName adalah null.

ArgumentException

entitySetName adalah string kosong.

-atau-

entity tidak memiliki properti kunci yang ditentukan.

InvalidOperationException

entity sudah dilacak oleh konteks.

Keterangan

Jika entitas adalah bagian dari grafik objek, operasi ini tidak melintasi grafik untuk menambahkan objek terkait. Ini adalah operasi dangkal.

Metode ini tidak memvalidasi apakah kumpulan entitas yang ditentukan terjadi dalam layanan data yang terkait dengan DataServiceContext.

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.

public:
 void AttachTo(System::String ^ entitySetName, System::Object ^ entity, System::String ^ etag);

public void AttachTo (string entitySetName, object entity, string etag);

member this.AttachTo : string * obj * string -> unit

Public Sub AttachTo (entitySetName As String, entity As Object, etag As String)

Parameter

entitySetName

String

Nilai string yang berisi nama entitas yang diatur ke entitas yang dilampirkan.

entity

Object

Entitas yang akan ditambahkan.

etag

String

Nilai etag yang mewakili status entitas terakhir kali diambil dari layanan data. Nilai ini diperlakukan sebagai string buram; tidak ada validasi yang dilakukan di atasnya oleh pustaka klien.

Pengecualian

ArgumentNullException

entitySetNameadalah null.

-atau-

entityadalah null.

ArgumentException

entitySetName adalah string kosong.

-atau-

Objek yang disediakan tidak memiliki properti kunci.

InvalidOperationException

Objek yang disediakan sudah dilacak oleh konteks.

Keterangan

Memanggil metode ini memberi tahu DataServiceContext untuk mulai melacak entitas yang ditentukan dan mengidentifikasi entitas yang ditetapkan tempat entitas berada.

Jika entitas adalah bagian dari grafik objek, operasi ini tidak melintasi grafik untuk menambahkan objek terkait. Objek ditambahkan ke DataServiceContext dalam status tidak berubah. Metode ini tidak memvalidasi apakah kumpulan entitas yang ditentukan terjadi dalam layanan data yang terkait dengan DataServiceContext.

Jika kelebihan beban dengan etag digunakan, etag yang ditentukan dikaitkan dengan entitas yang baru terpasang. Etag kemudian dikirim ke layanan data, dengan semua operasi pembaruan atau kueri berikutnya untuk entitas, menurut semantik HTTP. Pembuatan manual nilai etag tidak disarankan, tetapi kelebihan beban ini disediakan untuk memungkinkan entitas yang mungkin telah diserialisasikan dan disimpan untuk dipasang kembali bersama dengan metadata konkurensi yang relevan.