ObjectContext.AttachTo(String, Object) Méthode

Définition

Espace de noms:

System.Data.Objects

Assembly:

System.Data.Entity.dll

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.

entity

Object

Object à attacher.

Exceptions

ArgumentNullException

entity a la valeur null.

InvalidOperationException

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 de mise en entitySetName forme sont les suivantes :

• Si la propriété a la valeur , le entitySetName doit être qualifié entièrement comme dans <Nom> du conteneur d’entité.nullDefaultContainerName<Nom de> l’ensemble d’entités.

• Si n’est DefaultContainerName pas null, le peut être l’un ou l’autre <nom du conteneur d’entités>entitySetName.<Nom> du jeu d’entités ou <Nom du jeu 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 entitySetName ne peut pas s’agir 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 .

Voir aussi

• Attach(TEntity)
• Utilisation des objets (Entity Framework)