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 objet ou graphique d'objet au contexte de l'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 un objet EntityKey et l’objet EntitySet ne correspond pas au jeu d’entités passé comme argument de la méthode.
- ou -
L'objet n'a pas d'objet EntityKey et aucun jeu d'entités n'est fourni.
- ou -
Un objet du graphique d'objet a un objet EntityKey temporaire.
- ou -
Un objet du graphique d'objet a un objet EntityKey non valide (par exemple, les valeurs dans la clé ne correspondent pas à celles dans l'objet).
- ou -
Le jeu d'entités est introuvable à partir d'un nom entitySetName
et d'un nom de conteneur d'entités donnés.
- ou -
Un objet du graphique d'objet existe déjà dans un autre gestionnaire d'état.
Remarques
Appelez AttachTo sur pour ObjectContext attacher l’objet à un jeu d’entités spécifique dans le contexte de l’objet ou si l’objet a une null
valeur (Nothing
en Visual Basic). EntityKey Pour plus d’informations, consultez Attachement et détachement d’objets.
L'objet qui est attaché peut être un objet unique ou une partie du graphique.
Les règles du entitySetName
format sont les suivantes :
Si la DefaultContainerName propriété est
null
, leentitySetName
doit être entièrement qualifié comme dans <Nom> du conteneur d’entité.<Nom de> l’ensemble d’entités.Si n’est pas , le peut être l’un ou l’autre
entitySetName
<nom du> conteneur d’entités.null
DefaultContainerName<Nom de> l’ensemble d’entités ou <Nom de l’ensemble d’entités>.
Il n'est pas obligatoire qu'un objet EntityKey soit associé à l'objet qui est attaché. Si l’objet n’a pas de clé d’entité, il ne peut pas s’agir entitySetName
d’une chaîne vide.
Si l’objet attaché a une EntityKey valeur et entitySetName
a une valeur, le EntitySet de la clé d’entité doit correspondre au EntitySet qui a été trouvé en fonction du nom du entitySetName
conteneur d’entité et.