DataServiceContext.AttachTo Yöntem

Tanım

Ad Alanı:

System.Data.Services.Client

Bütünleştirilmiş Kod:

System.Data.Services.Client.dll

belirtilen kaynağı izlemeye başlamasını bildirir DataServiceContext ve belirtilen kaynak kümesindeki kaynağın konumunu sağlar.

Aşırı Yüklemeler

Name	Description
AttachTo(String, Object)	belirtilen kaynağı izlemeye başlamasını bildirir DataServiceContext ve kaynağın belirtilen kaynak kümesi içindeki konumunu sağlar.
AttachTo(String, Object, String)	belirtilen kaynağı izlemeye başlamasını bildirir DataServiceContext ve belirtilen kaynak kümesindeki kaynağın konumunu sağlar.

AttachTo(String, Object)

belirtilen kaynağı izlemeye başlamasını bildirir DataServiceContext ve kaynağın belirtilen kaynak kümesi içindeki konumunu sağlar.

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)

Parametreler

entitySetName

String

Kaynağı içeren kümenin adı.

entity

Object

tarafından DataServiceContextizlenecek kaynak. Kaynak, Değişmemiş durumuna eklenir.

Özel durumlar

ArgumentNullException

entity veya entitySetName şeklindedir null.

ArgumentException

entitySetName boş bir dizedir.

-veya-

entity tanımlanmış bir anahtar özelliğine sahip değil.

InvalidOperationException

entity bağlam tarafından zaten izleniyor.

Açıklamalar

Varlık bir nesne grafiğinin parçasıysa, bu işlem ilgili nesneleri eklemek için grafikte dolaşmaz. Bu sığ bir operasyon.

yöntemi, belirtilen varlık kümesinin ile DataServiceContextilişkili veri hizmetinde olup olmadığını doğrulamaz.

AttachTo(String, Object, String)

belirtilen kaynağı izlemeye başlamasını bildirir DataServiceContext ve belirtilen kaynak kümesindeki kaynağın konumunu sağlar.

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)

Parametreler

entitySetName

String

Varlığa iliştirilen varlık kümesinin adını içeren dize değeri.

entity

Object

Eklenecek varlık.

etag

String

Veri hizmetinden en son alındığında varlığın durumunu temsil eden bir etag değeri. Bu değer opak bir dize olarak değerlendirilir; istemci kitaplığı tarafından üzerinde doğrulama yapılmaz.

Özel durumlar

ArgumentNullException

entitySetName, null'e eşittir.

-veya-

entity, null'e eşittir.

ArgumentException

entitySetName boş bir dizedir.

-veya-

Sağlanan nesnenin anahtar özelliği yok.

InvalidOperationException

Sağlanan nesne bağlam tarafından zaten izleniyor.

Açıklamalar

Bu yöntemin çağrılması, belirtilen varlığı izlemeye başlamasını bildirir DataServiceContext ve varlığın ait olduğu varlık kümesini tanımlar.

Varlık bir nesne grafiğinin parçasıysa, bu işlem ilgili nesneleri eklemek için grafikte dolaşmaz. nesnesine DataServiceContext değişmemiş durumda eklenir. yöntemi, belirtilen varlık kümesinin ile DataServiceContextilişkilendirilmiş veri hizmetinde olup olmadığını doğrulamaz.

Bir etag ile aşırı yükleme kullanılırsa, belirtilen etag yeni eklenen varlıkla ilişkilendirilir. Daha sonra etag, HTTP semantiğine göre varlık için sonraki tüm güncelleştirme veya sorgu işlemleriyle birlikte veri hizmetine gönderilir. Etag değerlerinin el ile oluşturulması önerilmez, ancak bu aşırı yükleme, serileştirilmiş ve depolanmış olabilecek varlıkların ilgili eşzamanlılık meta verileriyle birlikte yeniden eklenmesini sağlamak için sağlanır.