ObjectContext.AttachTo(String, Object) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Anexa um objeto ou grafo de objetos ao contexto do objeto num 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 do conjunto da entidade, que pode opcionalmente ser qualificado pelo nome do contentor da entidade.
Exceções
O entity é null.
Entidade inválida definida.
-ou-
O objeto tem uma chave temporária.
-ou-
O objeto tem um EntityKey e não EntitySet corresponde ao conjunto de entidades passado como argumento do método.
-ou-
O objeto não tem um EntityKey conjunto de entidades e não é fornecido.
-ou-
Qualquer objeto do grafo-objeto tem um .EntityKey
-ou-
Qualquer objeto do grafo de objetos tem um valor inválido EntityKey (por exemplo, valores na chave não correspondem aos valores do objeto).
-ou-
O conjunto de entidades não podia ser encontrado a partir de um nome dado entitySetName e do nome do contentor da entidade.
-ou-
Qualquer objeto do grafo de objetos já existe noutro gestor de estados.
Observações
Chame AttachTo no ObjectContext para anexar o objeto a um conjunto específico de entidades no contexto do objeto ou se o objeto tiver um valor null (Nothing em Visual Basic) EntityKey. Para obter mais informações, consulte Anexando e desanexando objetos.
O objeto anexado pode ser um único objeto ou fazer parte do grafo.
As regras para o entitySetName formato são as seguintes:
Se a DefaultContainerName propriedade for
null, então oentitySetNametem de ser totalmente qualificado, como em <Nome> do Contentor da Entidade.<Nome> do conjunto da entidade.Se o não for , então pode
entitySetNameser Nome<> do Contentor da Entidade.nullDefaultContainerName<Nome> do conjunto da entidade ou <nome> do conjunto da entidade.
O objeto a ser fixado não é obrigatório ter uma EntityKey associação. Se o objeto não tiver uma chave de entidade, então entitySetName não pode ser uma cadeia vazia.
Se o objeto anexado tiver um EntityKey e tiver um valor, então a EntitySet chave da entidade deve corresponder à EntitySet que foi encontrada com base no entitySetName nome do contentor da entidade entitySetName e .