DataServiceContext.AttachTo Método

Definição

Namespace:

System.Data.Services.Client

Assembly:

System.Data.Services.Client.dll

Notifica o DataServiceContext para começar a acompanhar o recurso especificado e fornece o local do recurso no conjunto de recursos especificado.

Sobrecargas

AttachTo(String, Object)	Notifica o DataServiceContext para começar a acompanhar o recurso especificado e fornece o local do recurso dentro do conjunto de recursos especificado.
AttachTo(String, Object, String)	Notifica o DataServiceContext para começar a acompanhar o recurso especificado e fornece o local do recurso no conjunto de recursos especificado.

AttachTo(String, Object)

Notifica o DataServiceContext para começar a acompanhar o recurso especificado e fornece o local do recurso dentro do 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 é 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 acompanhado pelo contexto.

Comentários

Se a entidade fizer parte de um grafo de objeto, essa operação não atravessará 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 começar a acompanhar o 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 da cadeia de caracteres que contém o nome da entidade definida à 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 em que ela foi recuperada do serviço de dados. Esse valor é tratado como uma cadeia de caracteres opaca; nenhuma validação é executada nela pela biblioteca de clientes.

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 acompanhado pelo contexto.

Comentários

Chamar esse método notifica o DataServiceContext para começar a acompanhar a entidade especificada e identifica o conjunto de entidades ao qual a entidade pertence.

Se a entidade fizer parte de um grafo de objeto, essa operação não atravessará o grafo para adicionar objetos relacionados. O objeto é adicionado à 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 subsequentes de atualização ou consulta 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 habilitar entidades que podem ter sido serializadas e armazenadas para serem reanexadas junto com metadados de simultaneidade relevantes.