DataServiceContext.AttachTo 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.
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 -> unitPublic 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
entity ou entitySetName est null.
entitySetName est une chaîne vide.
-ou-
entity n’a pas de propriété de clé définie.
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.
S’applique à
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 -> unitPublic 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
entitySetName est une chaîne vide.
-ou-
L’objet fourni n’a pas de propriété de clé.
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.
