DataServiceContext.AttachTo Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 è 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.