DataServiceContext.AttachTo Metoda

Definice

Obor názvů:

System.Data.Services.Client

Sestavení:

System.Data.Services.Client.dll

Upozorní, DataServiceContext že má začít sledovat zadaný prostředek a poskytne umístění prostředku v zadané sadě prostředků.

Přetížení

AttachTo(String, Object)	Upozorní , DataServiceContext aby začal sledovat zadaný prostředek, a poskytne umístění prostředku v rámci zadané sady prostředků.
AttachTo(String, Object, String)	Upozorní, DataServiceContext že má začít sledovat zadaný prostředek a poskytne umístění prostředku v zadané sadě prostředků.

AttachTo(String, Object)

Upozorní , DataServiceContext aby začal sledovat zadaný prostředek, a poskytne umístění prostředku v rámci zadané sady 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

Prostředek, který má sledovat .DataServiceContext Prostředek se připojí 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 vlastnost klíče.

InvalidOperationException

entity je již sledován kontextem.

Poznámky

Pokud je entita součástí grafu objektů, tato operace neprochází grafem a nepřidává související objekty. Je to mělká operace.

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

AttachTo(String, Object, String)

Upozorní, DataServiceContext že má začít sledovat zadaný prostředek a poskytne 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

Hodnota řetězce, která obsahuje název entity sady, ke které je připojena entita.

entity

Object

Entita, která se má přidat.

etag

String

Hodnota etag, která představuje stav entity při jejím posledním načtení z datové služby. Tato hodnota je považována za neprůzrů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á vlastnost klíče.

InvalidOperationException

Zadaný objekt je již sledován kontextem.

Poznámky

Voláním této metody oznámíte, DataServiceContext že má začít sledovat zadanou entitu a identifikuje sadu entit, do které entita patří.

Pokud je entita součástí grafu objektů, tato operace neprochází grafem a nepřidává související objekty. Objekt se přidá do objektu DataServiceContext v nezměněném stavu. Metoda neověřuje, jestli se zadaná sada entit vyskytuje v datové službě přidružené k DataServiceContext.

Pokud je použito přetížení se značkou etag, je zadaná značka etag přidružena k nově připojené entitě. Značka etag se pak odešle do datové služby se všemi následnými operacemi aktualizace nebo dotazování entity podle sémantiky HTTP. Ruční generování hodnot etag se nedoporučuje, ale toto přetížení je k dispozici k umožnění entit, které mohou být serializovány a uloženy znovu připojit spolu s relevantními metadaty souběžnosti.