ObjectContext.AttachTo(String, Object) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Attache un graphique d’objet ou d’objet au contexte d’objet dans un jeu d’entités spécifique.
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)
Paramètres
- entitySetName
- String
Représente le nom du jeu d’entités, qui peut éventuellement être qualifié par le nom du conteneur d’entités.
Exceptions
entity a la valeur null.
Jeu d’entités non valide.
- ou -
L’objet a une clé temporaire.
- ou -
L’objet a une EntityKey valeur et ne EntitySet correspond pas au jeu d’entités passé en tant qu’argument de la méthode.
- ou -
L’objet n’a pas de jeu d’entités EntityKey et aucun jeu d’entités n’est fourni.
- ou -
Tout objet du graphe d’objets a un objet temporaire EntityKey.
- ou -
Tout objet du graphe d’objets n’est pas valide EntityKey (par exemple, les valeurs de la clé ne correspondent pas aux valeurs de l’objet).
- ou -
Impossible de trouver l’ensemble d’entités à partir d’un nom donné entitySetName et d’un nom de conteneur d’entités.
- ou -
Tout objet du graphe d’objets existe déjà dans un autre gestionnaire d’état.
Remarques
Appelez AttachTo l’objet ObjectContext pour attacher l’objet à un jeu d’entités spécifique dans le contexte de l’objet ou si l’objet a une null valeur (Nothingen Visual Basic). EntityKey Pour plus d’informations, consultez Attachement et détachement d’objets.
L’objet attaché peut être un objet unique ou faire partie du graphique.
Les règles du entitySetName format sont les suivantes :
Si la DefaultContainerName propriété est
null, laentitySetNamepropriété doit être entièrement qualifiée comme dans <Entity Container Name>.<Nom> de l’ensemble d’entités.Si ce n’est pas
nullle DefaultContainerName cas, ilentitySetNamepeut s’agir d’un <nom> de conteneur d’entités.<Nom> de l’ensemble d’entités ou <nom> du jeu d’entités.
L’objet attaché n’est pas requis pour avoir un EntityKey objet associé à celui-ci. Si l’objet n’a pas de clé d’entité, il entitySetName ne peut pas s’agir d’une chaîne vide.
Si l’objet joint a une EntityKey valeur et entitySetName a une valeur, la EntitySet clé d’entité doit correspondre à celle EntitySet qui a été trouvée en fonction du nom du conteneur d’entité et de l’entité entitySetName .