Méthode 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é.
Espace de noms : System.Data.Services.Client
Assembly : Microsoft.Data.Services.Client (en Microsoft.Data.Services.Client.dll)
Syntaxe
'Déclaration
Public Sub AttachTo ( _
entitySetName As String, _
entity As Object, _
etag As String _
)
'Utilisation
Dim instance As DataServiceContext
Dim entitySetName As String
Dim entity As Object
Dim etag As String
instance.AttachTo(entitySetName, entity, _
etag)
public void AttachTo(
string entitySetName,
Object entity,
string etag
)
public:
void AttachTo(
String^ entitySetName,
Object^ entity,
String^ etag
)
member AttachTo :
entitySetName:string *
entity:Object *
etag:string -> unit
public function AttachTo(
entitySetName : String,
entity : Object,
etag : String
)
Paramètres
- entitySetName
Type : System.String
Valeur de chaîne qui contient le nom du jeu d'entités auquel l'entité est attachée.
- entity
Type : System.Object
Entité à ajouter.
- etag
Type : System.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
| Exception | Condition |
|---|---|
| ArgumentNullException | Lorsque entitySetName est nullune référence Null (Nothing dans Visual Basic). ou Lorsque entity est nullune référence Null (Nothing dans Visual Basic). |
| ArgumentException | Lorsque entitySetName est une chaîne vide. ou Lorsque l'objet fourni n'a pas de propriété de clé. |
| InvalidOperationException | Lorsque l'objet fourni est déjà suivi par le contexte. |
Notes
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.