DataServiceContext.AttachTo Metodo

Definizione

Spazio dei nomi:

System.Data.Services.Client

Assembly:

System.Data.Services.Client.dll

Notifica a DataServiceContext di iniziare a rilevare la risorsa specificata e fornisce il percorso della risorsa nel set di risorse specificato.

Overload

AttachTo(String, Object)	Notifica a DataServiceContext di iniziare a rilevare la risorsa specificata e fornisce il percorso della risorsa all'interno del set di risorse specificato.
AttachTo(String, Object, String)	Notifica a DataServiceContext di iniziare a rilevare la risorsa specificata e fornisce il percorso della risorsa nel set di risorse specificato.

AttachTo(String, Object)

Notifica a DataServiceContext di iniziare a rilevare la risorsa specificata e fornisce il percorso 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 contenente la risorsa.

entity

Object

Risorsa che verrà rilevata da DataServiceContext. La risorsa viene associata nello stato non modificato.

Eccezioni

ArgumentNullException

entity o entitySetName è null.

ArgumentException

Il parametro entitySetName è una stringa vuota.

-oppure-

entity non dispone di una proprietà chiave definita.

InvalidOperationException

entity è già monitorato dal contesto.

Commenti

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

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

AttachTo(String, Object, String)

Notifica a DataServiceContext di iniziare a rilevare la risorsa specificata e fornisce il percorso 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 di stringa contenente il nome del set a cui è associata l'entità.

entity

Object

Entità da aggiungere.

etag

String

Valore etag che rappresenta lo stato dell'entità al momento dell'ultimo recupero dal servizio dati. Questo valore viene trattato come stringa opaca. Non viene eseguita alcuna convalida da parte della libreria client.

Eccezioni

ArgumentNullException

entitySetName è null.

-oppure-

entity è null.

ArgumentException

Il parametro entitySetName è una stringa vuota.

-oppure-

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

InvalidOperationException

L'oggetto fornito è già in fase di rilevamento dal contesto.

Commenti

La chiamata di questo metodo notifica a DataServiceContext di iniziare a rilevare l'entità specificata e identifica il set di entità a cui appartiene l'entità.

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

Se viene utilizzato l'overload con un etag, l'etag specificato viene associato all'entità appena collegata. L'etag viene quindi inviato al servizio dati, con eventuali operazioni di query o aggiornamento successive per l'entità, sulla base della semantica HTTP. Non è consigliabile generare manualmente valori etag, ma questo overload viene fornito per abilitare entità che possono essere state serializzate e archiviate per poter essere riassociate ai relativi metadati di concorrenza.