Freigeben über


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.

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.

Siehe auch

Verweis

DataServiceContext Klasse

System.Data.Services.Client-Namespace