DataServiceContext.AttachTo Método

Definição

Namespace:

System.Data.Services.Client

Assembly:

System.Data.Services.Client.dll

Notifica o DataServiceContext para iniciar o acompanhamento do recurso especificado e fornece o local do recurso no conjunto de recursos especificado.

Sobrecargas

AttachTo(String, Object)	Notifica o DataServiceContext para iniciar o acompanhamento do recurso especificado e fornece o local do recurso no conjunto de recursos especificado.
AttachTo(String, Object, String)	Notifica o DataServiceContext para iniciar o acompanhamento do recurso especificado e fornece o local do recurso no conjunto de recursos especificado.

AttachTo(String, Object)

Notifica o DataServiceContext para iniciar o acompanhamento do recurso especificado e fornece o local do recurso no conjunto de recursos especificado.

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)

Parâmetros

entitySetName

String

O nome do conjunto que contém o recurso.

entity

Object

O recurso a ser acompanhado pelo DataServiceContext. O recurso está anexado no estado Inalterado.

Exceções

ArgumentNullException

entity ou entitySetName é null.

ArgumentException

entitySetName é uma cadeia de caracteres vazia.

- ou -

entity não tem uma propriedade de chave definida.

InvalidOperationException

entity já está sendo rastreado pelo contexto.

Comentários

Se a entidade fizer parte de um grafo de objeto, essa operação não percorrerá o grafo para adicionar objetos relacionados. É uma operação superficial.

O método não valida se o conjunto de entidades especificado ocorre no serviço de dados associado ao DataServiceContext.

AttachTo(String, Object, String)

Notifica o DataServiceContext para iniciar o acompanhamento do recurso especificado e fornece o local do recurso no conjunto de recursos especificado.

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)

Parâmetros

entitySetName

String

O valor de cadeia de caracteres que contém o nome do conjunto de entidades ao qual a entidade está anexada.

entity

Object

A entidade a ser adicionada.

etag

String

Um valor de Etag que representa o estado da entidade na última vez que ela foi recuperada do serviço de dados. Esse valor é tratado como uma cadeia de caracteres opaca; nenhuma validação é executada pela biblioteca de cliente.

Exceções

ArgumentNullException

entitySetName é null.

- ou -

entity é null.

ArgumentException

entitySetName é uma cadeia de caracteres vazia.

- ou -

O objeto fornecido não tem uma propriedade de chave.

InvalidOperationException

O objeto fornecido já está sendo rastreado pelo contexto.

Comentários

Chamar esse método notifica o DataServiceContext para começar a acompanhar a entidade especificada e identifica a entidade definida à qual a entidade pertence.

Se a entidade fizer parte de um grafo de objeto, essa operação não percorrerá o grafo para adicionar objetos relacionados. O objeto é adicionado ao DataServiceContext no estado inalterado. O método não valida se o conjunto de entidades especificado ocorre no serviço de dados associado ao DataServiceContext.

Se a sobrecarga com uma etag for usada, a etag especificada será associada à entidade recém-anexada. Em seguida, a etag é enviada para o serviço de dados, com todas as operações de atualização ou consulta subsequentes para a entidade, de acordo com a semântica HTTP. A geração manual de valores de etag não é recomendada, mas essa sobrecarga é fornecida para permitir que entidades que podem ter sido serializadas e armazenadas sejam reanexadas junto com metadados de simultaneidade relevantes.