DataServiceContext.AttachTo Metoda

Definicja

Przestrzeń nazw:

System.Data.Services.Client

Zestaw:

System.Data.Services.Client.dll

Powiadamia element o DataServiceContext rozpoczęciu śledzenia określonego zasobu i dostarcza lokalizację zasobu w określonym zestawie zasobów.

Przeciążenia

AttachTo(String, Object)	Powiadamia użytkownika o DataServiceContext rozpoczęciu śledzenia określonego zasobu i dostarcza lokalizację zasobu w określonym zestawie zasobów.
AttachTo(String, Object, String)	Powiadamia element o DataServiceContext rozpoczęciu śledzenia określonego zasobu i dostarcza lokalizację zasobu w określonym zestawie zasobów.

AttachTo(String, Object)

Powiadamia użytkownika o DataServiceContext rozpoczęciu śledzenia określonego zasobu i dostarcza lokalizację zasobu w określonym zestawie zasobów.

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)

Parametry

entitySetName

String

Nazwa zestawu zawierającego zasób.

entity

Object

Zasób, który ma być śledzony przez DataServiceContextelement . Zasób jest dołączony w stanie Bez zmian.

Wyjątki

ArgumentNullException

entity lub entitySetName to null.

ArgumentException

entitySetName jest pustym ciągiem.

-lub-

entity nie ma zdefiniowanej właściwości klucza.

InvalidOperationException

entity jest już śledzony przez kontekst.

Uwagi

Jeśli jednostka jest częścią grafu obiektu, ta operacja nie przechodzi przez graf w celu dodania powiązanych obiektów. Jest to płytkia operacja.

Metoda nie sprawdza, czy określony zestaw jednostek występuje w usłudze danych skojarzonej z usługą DataServiceContext.

AttachTo(String, Object, String)

Powiadamia element o DataServiceContext rozpoczęciu śledzenia określonego zasobu i dostarcza lokalizację zasobu w określonym zestawie zasobów.

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)

Parametry

entitySetName

String

Wartość ciągu zawierająca nazwę jednostki, do której jest dołączona jednostka.

entity

Object

Jednostka do dodania.

etag

String

Wartość znacznika etag reprezentująca stan jednostki po raz ostatni pobrana z usługi danych. Ta wartość jest traktowana jako nieprzezroczystych ciągów; w bibliotece klienta nie jest wykonywana żadna walidacja.

Wyjątki

ArgumentNullException

entitySetName to null.

-lub-

entity to null.

ArgumentException

entitySetName jest pustym ciągiem.

-lub-

Podany obiekt nie ma właściwości klucza.

InvalidOperationException

Podany obiekt jest już śledzony przez kontekst.

Uwagi

Wywołanie tej metody powiadamia obiekt DataServiceContext o rozpoczęciu śledzenia określonej jednostki i identyfikuje jednostkę ustawioną na jednostkę, do której należy jednostka.

Jeśli jednostka jest częścią grafu obiektu, ta operacja nie przechodzi przez graf w celu dodania powiązanych obiektów. Obiekt jest dodawany do DataServiceContext obiektu w niezmienionym stanie. Metoda nie sprawdza, czy określony zestaw jednostek występuje w usłudze danych skojarzonej z usługą DataServiceContext.

Jeśli jest używane przeciążenie z tagiem etag, określony element etag jest skojarzony z nowo dołączoną jednostką. Element etag jest następnie wysyłany do usługi danych z wszystkimi kolejnymi operacjami aktualizacji lub zapytań dla jednostki, zgodnie z semantykami HTTP. Ręczne generowanie wartości etag nie jest zalecane, ale to przeciążenie jest udostępniane w celu włączenia jednostek, które mogły zostać serializowane i przechowywane do ponownego dołączenia wraz z odpowiednimi metadanymi współbieżności.