Metodo DataServiceContext.AddObject
Aggiunge l'oggetto specificato al set di oggetti rilevato da DataServiceContext.
Spazio dei nomi System.Data.Services.Client
Assembly: Microsoft.Data.Services.Client (in Microsoft.Data.Services.Client.dll)
Sintassi
'Dichiarazione
Public Sub AddObject ( _
entitySetName As String, _
entity As Object _
)
'Utilizzo
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
)
Parametri
- entitySetName
Tipo: System.String
Nome del set di entità a cui verrà aggiunta la risorsa.
- entity
Tipo: System.Object
Oggetto che verrà rilevato da DataServiceContext.
Eccezioni
Eccezione | Condizione |
---|---|
ArgumentNullException | Se entitySetName o entity è Null. |
ArgumentException | Se entitySetName è vuoto. -oppure- Se entity non dispone di una proprietà della chiave definita. |
InvalidOperationException | Se l'entità è già rilevata dal contesto. |
Osservazioni
L'oggetto viene inserito nel set di rilevamento di DataServiceContext nello stato Added. DataServiceContext tenterà di inserire l'oggetto mediante HTTP POST alla successiva chiamata a SaveChanges. Questo metodo non aggiunge oggetti correlati all'entità specificata a DataServiceContext. Ogni oggetto deve essere aggiunto tramite una chiamata separata a AddObject.
Il metodo non convalida che il set di entità specificato si trova nel servizio dati associato a DataServiceContext o che l'oggetto aggiunto dispone delle proprietà necessarie per l'aggiunta al set di entità specificato.