ObjectContext.AttachTo(String, Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> unitPublic 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.
Exceções
O entity é null.
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, oentitySetNamedeverá ser totalmente qualificado como no <Nome> do Contêiner da Entidade.<Nome> do Conjunto de Entidades.Se o DefaultContainerName não
nullfor , oentitySetNamepoderá 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 .
