Méthode DataServiceContext.AddObject
Ajoute l'objet spécifié à l'ensemble d'objets suivis par DataServiceContext.
Espace de noms : System.Data.Services.Client
Assembly : Microsoft.Data.Services.Client (en Microsoft.Data.Services.Client.dll)
Syntaxe
'Déclaration
Public Sub AddObject ( _
entitySetName As String, _
entity As Object _
)
'Utilisation
Dim instance As DataServiceContext
Dim entitySetName As String
Dim entity As Object
instance.AddObject(entitySetName, entity)
public void AddObject(
string entitySetName,
Object entity
)
public:
void AddObject(
String^ entitySetName,
Object^ entity
)
member AddObject :
entitySetName:string *
entity:Object -> unit
public function AddObject(
entitySetName : String,
entity : Object
)
Paramètres
- entitySetName
Type : System.String
Nom du jeu d'entités auquel la ressource sera ajoutée.
- entity
Type : System.Object
Objet à suivre par le DataServiceContext.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | Lorsque entitySetName ou entity est null. |
| ArgumentException | Lorsque entitySetName est vide. ou Lorsque entity n'a pas de propriété de clé définie. |
| InvalidOperationException | Lorsque l'entité est déjà suivie par le contexte. |
Notes
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é est situé dans le service de données associé au DataServiceContext ou que l'objet ajouté a les propriétés requises nécessaires pour être ajouté au jeu d'entités spécifié.