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 grafo de objeto ao contexto do 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 do conjunto de entidades, que pode ser opcionalmente qualificado pelo nome do contêiner da 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 o EntitySet conjunto de entidades não corresponde ao 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 do grafo de objeto tem um .EntityKey
- ou -
Qualquer objeto do grafo de objeto tem um valor inválido EntityKey (por exemplo, os valores na chave não correspondem aos valores no objeto).
- ou -
Não foi possível encontrar o conjunto de entidades de um determinado entitySetName nome e nome de contêiner de entidade.
- ou -
Qualquer objeto do grafo de objeto já existe em outro gerenciador de estado.
Comentários
Chame AttachTo para ObjectContext anexar o objeto a um conjunto de entidades específico 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, aentitySetNamepropriedade deverá ser totalmente qualificada como no <Nome> do Contêiner da Entidade.<Nome> do conjunto de entidades.Se não DefaultContainerName
nullestiver, poderá ser oentitySetName<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 valor e entitySetName tiver um valor, a EntitySet chave da entidade deverá corresponder ao EntitySet que foi encontrado com base no nome do contêiner e da entitySetName entidade.