DataServiceContext.AddObject Método
Agrega el objeto especificado al conjunto de objetos cuyo seguimiento realiza DataServiceContext.
Espacio de nombres: System.Data.Services.Client
Ensamblado: Microsoft.Data.Services.Client (en Microsoft.Data.Services.Client.dll)
Sintaxis
'Declaración
Public Sub AddObject ( _
entitySetName As String, _
entity As Object _
)
'Uso
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
)
Parámetros
- entitySetName
Tipo: System.String
Nombre del conjunto de entidades al que se agregará el recurso.
- entity
Tipo: System.Object
Objeto del que DataServiceContext va a realizar el seguimiento.
Excepciones
Excepción | Condición |
---|---|
ArgumentNullException | Cuando entitySetName o entity es NULL. |
ArgumentException | Cuando entitySetName está vacío. O bien Cuando entity no tiene una propiedad clave definida. |
InvalidOperationException | Cuando el contexto ya está realizando el seguimiento de la entidad. |
Comentarios
El objeto se coloca en el conjunto de seguimiento de DataServiceContext en el estado Added. DataServiceContext intentará insertar el objeto mediante HTTP POST en la siguiente llamada a SaveChanges. Este método no agrega a DataServiceContext objetos relacionados con la entidad especificada. Cada objeto se debe agregar mediante una llamada independiente a AddObject.
El método no valida que el conjunto de entidades especificado está en el servicio de datos asociado a DataServiceContext o que el objeto agregado tiene las propiedades necesarias que hay que agregar al conjunto de entidades especificado.