DataServiceContext.AttachTo Méthode

Définition

Espace de noms:

System.Data.Services.Client

Assembly:

System.Data.Services.Client.dll

Informe le DataServiceContext qu'il doit commencer à suivre la ressource spécifiée et fournit l'emplacement de la ressource dans le jeu de ressources spécifié.

Surcharges

AttachTo(String, Object)	Informe le DataServiceContext qu'il doit commencer à suivre la ressource spécifiée et fournit l'emplacement de la ressource dans le jeu de ressources spécifié.
AttachTo(String, Object, String)	Informe le DataServiceContext qu'il doit commencer à suivre la ressource spécifiée et fournit l'emplacement de la ressource dans le jeu de ressources spécifié.

AttachTo(String, Object)

Informe le DataServiceContext qu'il doit commencer à suivre la ressource spécifiée et fournit l'emplacement de la ressource dans le jeu de ressources spécifié.

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

Nom de l'ensemble qui contient la ressource.

entity

Object

Ressource à suivre par le DataServiceContext. La ressource est attachée dans l'état inchangé.

Exceptions

ArgumentNullException

entity ou entitySetName est null.

ArgumentException

entitySetName est une chaîne vide.

-ou-

entity n’a pas de propriété de clé définie.

InvalidOperationException

entity est déjà suivi par le contexte.

Remarques

Si l'entité fait partie d'un graphique d'objets, cette opération ne parcourt pas le graphique pour ajouter des objets connexes. Il s'agit d'une opération superficielle.

La méthode ne valide pas si le jeu d'entités spécifié se trouve dans le service de données associé au DataServiceContext.

AttachTo(String, Object, String)

Informe le DataServiceContext qu'il doit commencer à suivre la ressource spécifiée et fournit l'emplacement de la ressource dans le jeu de ressources spécifié.

public:
 void AttachTo(System::String ^ entitySetName, System::Object ^ entity, System::String ^ etag);

public void AttachTo (string entitySetName, object entity, string etag);

member this.AttachTo : string * obj * string -> unit

Public Sub AttachTo (entitySetName As String, entity As Object, etag As String)

Paramètres

entitySetName

String

Valeur de chaîne qui contient le nom du jeu d'entités auquel l'entité est attachée.

entity

Object

Entité à ajouter.

etag

String

Valeur etag qui représente l'état de l'entité la dernière fois qu'elle a été récupérée du service de données. Cette valeur est traitée comme une chaîne opaque ; aucune validation n’est effectuée sur celle-ci par la bibliothèque cliente.

Exceptions

ArgumentNullException

entitySetName a la valeur null.

-ou-

entity a la valeur null.

ArgumentException

entitySetName est une chaîne vide.

-ou-

L’objet fourni n’a pas de propriété de clé.

InvalidOperationException

L’objet fourni est déjà suivi par le contexte.

Remarques

L'appel de cette méthode indique à DataServiceContext de démarrer le suivi de l'entité spécifiée et identifie le jeu d'entités auquel l'entité appartient.

Si l'entité fait partie d'un graphique d'objets, cette opération ne parcourt pas le graphique pour ajouter des objets connexes. L'objet est ajouté au DataServiceContext à l'état inchangé. La méthode ne valide pas si le jeu d'entités spécifié se trouve dans le service de données associé au DataServiceContext.

Si la surcharge avec un etag est utilisée, l'etag spécifié est associé à l'entité récemment attachée. L'etag est ensuite envoyé au service de données avec toutes les opérations de mise à jour ou de requête suivantes pour l'entité, selon la sémantique HTTP. La génération manuelle des valeurs d'etags n'est pas recommandée, mais cette surcharge permet de rattacher les entités qui ont peut-être été sérialisées et stockées aux métadonnées d'accès concurrentiel appropriées.