DataServiceContext.AddObject-Methode
Fügt das angegebene Objekt dem Satz von Objekten hinzu, den der DataServiceContext nachverfolgt.
Namespace: System.Data.Services.Client
Assembly: Microsoft.Data.Services.Client (in Microsoft.Data.Services.Client.dll)
Syntax
'Declaration
Public Sub AddObject ( _
entitySetName As String, _
entity As Object _
)
'Usage
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
)
Parameter
- entitySetName
Typ: System.String
Der Name der Entität, der die Ressource hinzugefügt wurde.
- entity
Typ: System.Object
Das Objekt, das vom DataServiceContext nachverfolgt werden soll.
Ausnahmen
Ausnahme | Bedingung |
---|---|
ArgumentNullException | Wenn entitySetName oder entity null ist. |
ArgumentException | Wenn entitySetName leer ist. - oder - Wenn entity keine definierte Schlüsseleigenschaft hat. |
InvalidOperationException | Wenn die Entität bereits vom Kontext nachverfolgt wird. |
Hinweise
Das Objekt wird in den Nachverfolgungssatz des DataServiceContext im Zustand Added gesetzt. DataServiceContext versucht, beim nächsten Aufruf von SaveChanges das Objekt mit HTTP POST einzufügen. Diese Methode fügt Objekte zu DataServiceContext hinzu, die mit der angegebenen Entität in Verbindung stehen. Jedes Objekt muss durch einen separaten Aufruf an AddObject hinzugefügt werden.
Die Methode überprüft nicht, ob die angegebene Entitätenmenge im Datendienst enthalten ist, der DataServiceContext zugeordnet wurde. Es wird auch nicht geprüft, ob das hinzugefügte Objekt über die erforderlichen Eigenschaften verfügt, die der Entitätenmenge hinzugefügt werden müssen.