DataServiceContext.AddObject(String, Object) Méthode

Définition

Espace de noms:

System.Data.Services.Client

Assembly:

System.Data.Services.Client.dll

Ajoute l'objet spécifié à l'ensemble d'objets suivis par DataServiceContext.

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

public void AddObject (string entitySetName, object entity);

member this.AddObject : string * obj -> unit

Public Sub AddObject (entitySetName As String, entity As Object)

Paramètres

entitySetName

String

Nom du jeu d'entités auquel la ressource sera ajoutée.

entity

Object

Objet à suivre par le DataServiceContext.

Exceptions

ArgumentNullException

entitySetName ou entity est null.

ArgumentException

entitySetName est vide.

- ou -

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

InvalidOperationException

L’entité est déjà suivie par le contexte.

Remarques

L'objet est placé dans le jeu de suivis du DataServiceContext à l'état Added. Le DataServiceContext essaiera d'insérer l'objet par HTTP POST lors de l'appel suivant à SaveChanges. Cette méthode n'ajoute pas d'objets liés à l'entité spécifiée au DataServiceContext. Chaque objet doit être ajouté via un appel séparé à AddObject.

La méthode ne valide pas que le jeu d’entités spécifié se trouve dans le service de données associé à ou DataServiceContext que l’objet ajouté possède les propriétés requises à ajouter au spécifié entity set.