ObjectContext.AttachTo(String, Object) Método

Definição

Namespace:

System.Data.Objects

Assembly:

System.Data.Entity.dll

Anexa um objeto ou um grafo de objeto ao contexto de objeto em um conjunto de entidades específico.

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

Representa o nome de conjunto de entidades, que pode, opcionalmente, ser qualificado pelo nome do contêiner de entidade.

entity

Object

O Object a ser anexado.

Exceções

ArgumentNullException

O entity é null.

InvalidOperationException

Conjunto de entidades inválido.

- ou -

O objeto tem uma chave temporária.

- ou -

O objeto tem um EntityKey e EntitySet não coincide com o conjunto de entidades passado como um argumento do método.

- ou -

O objeto não tem um EntityKey e nenhum conjunto de entidades é fornecido.

- ou -

Qualquer objeto de grafo de objetos tem um EntityKey temporário.

- ou -

Qualquer objeto do grafo de objetos tem um EntityKey inválido (por exemplo, valores da chave não correspondem aos valores no objeto).

- ou -

Não foi possível localizar o conjunto de entidades de um determinado nome e nome do contêiner de entidade do entitySetName.

- ou -

Qualquer objeto de grafo de objeto já existe em outro gerenciador de estado.

Comentários

Chame AttachTo no ObjectContext para anexar o objeto a uma entidade específica definida no contexto do objeto ou se o objeto tiver um null valor (Nothing no Visual Basic). EntityKey Para obter mais informações, consulte Anexar e desanexar objetos.

O objeto que está sendo anexado pode ser um único objeto ou fazer parte do grafo.

As regras para o formato são as entitySetName seguintes:

• Se a DefaultContainerName propriedade for null, o entitySetName deverá ser totalmente qualificado como no <Nome> do Contêiner da Entidade.<Nome> do Conjunto de Entidades.

• Se o DefaultContainerName não nullfor , o entitySetName poderá ser o <Nome> do Contêiner da Entidade.<Nome> do Conjunto de Entidades ou <Nome> do Conjunto de Entidades.

O objeto que está sendo anexado não é necessário para ter um EntityKey associado a ele. Se o objeto não tiver uma chave de entidade, não entitySetName poderá ser uma cadeia de caracteres vazia.

Se o objeto que está sendo anexado tiver um EntityKey e entitySetName tiver um valor, o EntitySet da chave de entidade deverá corresponder ao EntitySet que foi encontrado com base no nome do contêiner de entitySetName entidade e .

Confira também

• Attach(TEntity)
• Trabalhando com objetos (Entity Framework)