Udostępnij za pośrednictwem


DataServiceContext.AttachTo Metoda

Definicja

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

entity lub entitySetName to null.

entitySetName jest pustym ciągiem.

-lub-

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

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.

Dotyczy

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

entitySetName to null.

-lub-

entity to null.

entitySetName jest pustym ciągiem.

-lub-

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

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.

Dotyczy