DataServiceContext.BeginLoadProperty Método

Definição

Namespace:

System.Data.Services.Client

Assembly:

System.Data.Services.Client.dll

Inicia a operação para carregar o valor da propriedade especificada do serviço de dados.

Sobrecargas

BeginLoadProperty(Object, String, AsyncCallback, Object)	Carrega de forma assíncrona o valor da propriedade especificada do serviço de dados.
BeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object)	Carrega de forma assíncrona a próxima página de entidades relacionadas do serviço de dados usando o objeto de continuação de consulta fornecido.
BeginLoadProperty(Object, String, Uri, AsyncCallback, Object)	Carrega de forma assíncrona uma página de entidades relacionadas do serviço de dados usando o próximo URI de link fornecido.

BeginLoadProperty(Object, String, AsyncCallback, Object)

Carrega de forma assíncrona o valor da propriedade especificada do serviço de dados.

public:
 IAsyncResult ^ BeginLoadProperty(System::Object ^ entity, System::String ^ propertyName, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginLoadProperty (object entity, string propertyName, AsyncCallback callback, object state);

member this.BeginLoadProperty : obj * string * AsyncCallback * obj -> IAsyncResult

Public Function BeginLoadProperty (entity As Object, propertyName As String, callback As AsyncCallback, state As Object) As IAsyncResult

Parâmetros

entity

Object

A entidade que contém a propriedade a ser carregada.

propertyName

String

O nome da propriedade na entidade especificada a ser carregada.

callback

AsyncCallback

O delegado chamado quando uma resposta para a solicitação é recebida.

state

Object

O objeto de estado definido pelo usuário usado para passar dados de contexto ao método de retorno de chamada.

Retornos

IAsyncResult

Um IAsyncResult que representa o status da operação assíncrona.

Comentários

Chamar esse método invoca uma operação de rede para recuperar o valor de uma propriedade. A propriedade especificada pode ser qualquer uma das propriedades em uma entidade, incluindo propriedades que representam associações ou links. Se a propriedade representar uma associação ou link ou uma propriedade adiada, chamar esse método fornecerá ao cliente uma maneira de carregar os recursos relacionados de forma preguiçosa. Se a entidade estiver no estado modificado, o valor da propriedade carregará entidades relacionadas e as marcará e quaisquer links como inalterados.

Se a propriedade já estiver carregada, chamar esse método permitirá que você atualize o valor da propriedade.

BeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object)

Carrega de forma assíncrona a próxima página de entidades relacionadas do serviço de dados usando o objeto de continuação de consulta fornecido.

public:
 IAsyncResult ^ BeginLoadProperty(System::Object ^ entity, System::String ^ propertyName, System::Data::Services::Client::DataServiceQueryContinuation ^ continuation, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginLoadProperty (object entity, string propertyName, System.Data.Services.Client.DataServiceQueryContinuation continuation, AsyncCallback callback, object state);

member this.BeginLoadProperty : obj * string * System.Data.Services.Client.DataServiceQueryContinuation * AsyncCallback * obj -> IAsyncResult

Public Function BeginLoadProperty (entity As Object, propertyName As String, continuation As DataServiceQueryContinuation, callback As AsyncCallback, state As Object) As IAsyncResult

Parâmetros

entity

Object

A entidade que contém a propriedade a ser carregada.

propertyName

String

O nome da propriedade da entidade especificada a ser carregada.

continuation

DataServiceQueryContinuation

Um objeto DataServiceQueryContinuation<T> que representa a próxima página de dados da entidade relacionada a ser retornada do serviço de dados.

callback

AsyncCallback

Delegado a ser invocado quando os resultados estiverem disponíveis para consumo do cliente.

state

Object

Objeto de estado definido pelo usuário passado ao retorno de chamada.

Retornos

IAsyncResult

Um IAsyncResult que representa o status da operação.

Comentários

O objeto fornecido DataServiceQueryContinuation<T> contém o URI que, quando executado, retorna a próxima página de dados no resultado da consulta.

BeginLoadProperty(Object, String, Uri, AsyncCallback, Object)

Carrega de forma assíncrona uma página de entidades relacionadas do serviço de dados usando o próximo URI de link fornecido.

public:
 IAsyncResult ^ BeginLoadProperty(System::Object ^ entity, System::String ^ propertyName, Uri ^ nextLinkUri, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginLoadProperty (object entity, string propertyName, Uri nextLinkUri, AsyncCallback callback, object state);

member this.BeginLoadProperty : obj * string * Uri * AsyncCallback * obj -> IAsyncResult

Public Function BeginLoadProperty (entity As Object, propertyName As String, nextLinkUri As Uri, callback As AsyncCallback, state As Object) As IAsyncResult

Parâmetros

entity

Object

A entidade que contém a propriedade a ser carregada.

propertyName

String

O nome da propriedade da entidade especificada a ser carregada.

nextLinkUri

Uri

O URI usado para carregar a próxima página de resultados.

callback

AsyncCallback

Delegado a ser invocado quando os resultados estiverem disponíveis para consumo do cliente.

state

Object

Objeto de estado definido pelo usuário passado ao retorno de chamada.

Retornos

IAsyncResult

Um objeto IAsyncResult que é usado para acompanhar o status da operação assíncrona.

Comentários

Quando entity está em um Unchanged estado ou Modified , as entidades relacionadas são carregadas no Unchanged estado e os links entre as entidades também são criados em um Unchanged estado.

Quando entity está em um Deleted estado, as entidades relacionadas são carregadas no Unchanged estado e os links entre as entidades são criados no Deleted estado .