DataServiceContext.AttachTo Yöntem

Tanım

Ad Alanı:

System.Data.Services.Client

Bütünleştirilmiş Kod:

System.Data.Services.Client.dll

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

Aşırı Yüklemeler

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

AttachTo(String, Object)

DataServiceContext Belirtilen kaynağı izlemeye başlamasını bildirir ve belirtilen kaynak kümesi içindeki kaynağın 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. Yüzeysel bir operasyon.

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

AttachTo(String, Object, String)

DataServiceContext Belirtilen kaynağı izlemeye başlamasını bildirir 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ığın eklendiği 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; üzerinde istemci kitaplığı tarafından doğrulama yapılmaz.

Özel durumlar

ArgumentNullException

entitySetName, null değeridir.

-veya-

entity, null değeridir.

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 DataServiceContext çağrılması, belirtilen varlığı izlemeye başlamasını bildirir 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. nesnesi, DataServiceContext öğesine değişmemiş durumda eklenir. yöntemi, belirtilen varlık kümesinin ile DataServiceContextilişkili 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. Ardından 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, seri hale getirilmiş ve depolanmış varlıkların ilgili eşzamanlılık meta verileriyle birlikte yeniden eklenmesini sağlamak için sağlanır.