DataServiceContext.AttachTo Metoda

Definice

Obor názvů:

System.Data.Services.Client

Sestavení:

System.Data.Services.Client.dll

DataServiceContext Upozorní, aby zahájil sledování zadaného zdroje a poskytuje umístění prostředku v zadané sadě prostředků.

Přetížení

Name	Description
AttachTo(String, Object)	DataServiceContext Upozorní, aby začal sledovat zadaný zdroj a poskytuje umístění prostředku v zadané sadě prostředků.
AttachTo(String, Object, String)	DataServiceContext Upozorní, aby zahájil sledování zadaného zdroje a poskytuje umístění prostředku v zadané sadě prostředků.

AttachTo(String, Object)

DataServiceContext Upozorní, aby začal sledovat zadaný zdroj a poskytuje umístění prostředku v zadané sadě prostředků.

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

Název sady, která obsahuje prostředek.

entity

Object

Zdroj, který má být sledován nástrojem DataServiceContext. Prostředek je připojen v nezměněném stavu.

Výjimky

ArgumentNullException

entity nebo entitySetName je null.

ArgumentException

entitySetName je prázdný řetězec.

nebo

entity nemá definovanou klíčovou vlastnost.

InvalidOperationException

entity je již sledován kontextem.

Poznámky

Pokud je entita součástí objektového grafu, tato operace neprochází grafem, aby se přidaly související objekty. Je to mělká operace.

Metoda neověřuje, zda se zadaná sada entit vyskytuje v datové službě přidružené k DataServiceContext.

AttachTo(String, Object, String)

DataServiceContext Upozorní, aby zahájil sledování zadaného zdroje a poskytuje umístění prostředku v zadané sadě prostředků.

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

Řetězcová hodnota obsahující název entity nastavené na entitu, ke které je entita připojena.

entity

Object

Entita, která se má přidat.

etag

String

Hodnota značky etag, která představuje stav entity při posledním načtení z datové služby. Tato hodnota je považována za neprůzný řetězec; Klientská knihovna neprovádí žádné ověření.

Výjimky

ArgumentNullException

entitySetName je null.

nebo

entity je null.

ArgumentException

entitySetName je prázdný řetězec.

nebo

Zadaný objekt nemá klíčovou vlastnost.

InvalidOperationException

Zadaný objekt je již sledován kontextem.

Poznámky

Voláním této metody oznámíte DataServiceContext zahájení sledování zadané entity a identifikuje entitu, do které entita patří.

Pokud je entita součástí objektového grafu, tato operace neprochází grafem, aby se přidaly související objekty. Objekt se přidá do DataServiceContext nezměněného stavu. Metoda neověřuje, zda sada entit zadaná v datové službě přidružené k DataServiceContext.

Pokud se použije přetížení se značkou etag, je zadaná etag přidružena k nově připojené entitě. Etag se pak odešle do datové služby se všemi následnými operacemi aktualizace nebo dotazu pro entitu podle sémantiky HTTP. Ruční generování hodnot značky etag se nedoporučuje, ale toto přetížení je poskytováno tak, aby bylo možné entity, které byly serializovány a uloženy, aby se znovu připojovaly spolu s relevantními metadaty souběžnosti.