DataServiceContext.AttachTo Metodo

Definizione

Notifica all'oggetto DataServiceContext di avviare il rilevamento della risorsa specificata e fornisce la posizione della risorsa nel set di risorse specificato.

Overload

Nome Descrizione
AttachTo(String, Object)

Notifica all'oggetto DataServiceContext di avviare il rilevamento della risorsa specificata e fornisce la posizione della risorsa all'interno del set di risorse specificato.

AttachTo(String, Object, String)

Notifica all'oggetto DataServiceContext di avviare il rilevamento della risorsa specificata e fornisce la posizione della risorsa nel set di risorse specificato.

AttachTo(String, Object)

Notifica all'oggetto DataServiceContext di avviare il rilevamento della risorsa specificata e fornisce la posizione della risorsa all'interno del set di risorse specificato.

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)

Parametri

entitySetName
String

Nome del set che contiene la risorsa.

entity
Object

Risorsa da tenere traccia dell'oggetto DataServiceContext. La risorsa è collegata nello stato Non modificato.

Eccezioni

entity o entitySetName è null.

entitySetName è una stringa vuota.

oppure

entity non dispone di una proprietà chiave definita.

entity è già monitorato dal contesto.

Commenti

Se l'entità fa parte di un oggetto grafico, questa operazione non attraversa il grafico per aggiungere oggetti correlati. È un'operazione superficiale.

Il metodo non convalida se il set di entità specificato si verifica nel servizio dati associato a DataServiceContext.

Si applica a

AttachTo(String, Object, String)

Notifica all'oggetto DataServiceContext di avviare il rilevamento della risorsa specificata e fornisce la posizione della risorsa nel set di risorse specificato.

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)

Parametri

entitySetName
String

Valore stringa contenente il nome del set di entità a cui è associata l'entità.

entity
Object

Entità da aggiungere.

etag
String

Valore etag che rappresenta lo stato dell'entità l'ultima volta che è stato recuperato dal servizio dati. Questo valore viene considerato come una stringa opaca; non viene eseguita alcuna convalida dalla libreria client.

Eccezioni

entitySetName è null.

oppure

entity è null.

entitySetName è una stringa vuota.

oppure

L'oggetto fornito non dispone di una proprietà chiave.

L'oggetto fornito è già rilevato dal contesto.

Commenti

La chiamata a questo metodo notifica all'oggetto DataServiceContext per avviare il rilevamento dell'entità specificata e identifica il set di entità a cui appartiene l'entità.

Se l'entità fa parte di un oggetto grafico, questa operazione non attraversa il grafico per aggiungere oggetti correlati. L'oggetto viene aggiunto all'oggetto DataServiceContext nello stato invariato. Il metodo non convalida se il set di entità specificato si verifica nel servizio dati associato a DataServiceContext.

Se viene usato l'overload con un etag, l'etag specificato viene associato all'entità appena associata. L'etag viene quindi inviato al servizio dati, con tutte le operazioni di aggiornamento o query successive per l'entità, in base alla semantica HTTP. La generazione manuale dei valori etag non è consigliata, ma questo overload viene fornito per consentire alle entità che possono essere state serializzate e archiviate di essere ricollegate con i metadati di concorrenza pertinenti.

Si applica a