DataServiceContext.AddObject(String, Object) Método

Definição

Namespace:

System.Data.Services.Client

Assembly:

System.Data.Services.Client.dll

Adiciona o objeto especificado ao conjunto de objetos que DataServiceContext está acompanhando.

public:
 void AddObject(System::String ^ entitySetName, System::Object ^ entity);

public void AddObject (string entitySetName, object entity);

member this.AddObject : string * obj -> unit

Public Sub AddObject (entitySetName As String, entity As Object)

Parâmetros

entitySetName

String

O nome do conjunto de entidades ao qual o recurso será adicionado.

entity

Object

O objeto a ser acompanhado pelo DataServiceContext.

Exceções

ArgumentNullException

entitySetName ou entity é nulo.

ArgumentException

entitySetName está vazio.

- ou -

entity não tem uma propriedade de chave definida.

InvalidOperationException

A entidade já está sendo controlada pelo contexto.

Comentários

O objeto é colocado no conjunto de acompanhamento do DataServiceContext no Added estado . O DataServiceContext tentará inserir o objeto por HTTP POST na próxima chamada para SaveChanges. Esse método não adiciona objetos relacionados à entidade especificada ao DataServiceContext. Cada objeto deve ser adicionado por meio de uma chamada separada para AddObject.

O método não valida se o conjunto de entidades especificado está no serviço de dados associado DataServiceContext ao ou que o objeto adicionado tem as propriedades necessárias necessárias para ser adicionado ao especificado entity set.