DataServiceContext Classe

Definição

Namespace:

System.Data.Services.Client

Assembly:

System.Data.Services.Client.dll

O DataServiceContext representa o contexto do runtime do serviço de dados.

public ref class DataServiceContext

public class DataServiceContext

type DataServiceContext = class

Public Class DataServiceContext

Herança

Object

DataServiceContext

Exemplos

O exemplo a seguir mostra como usar o DataServiceContext gerado pela ferramenta Adicionar Referência de Serviço para executar implicitamente uma consulta no serviço de dados Northwind que retorna todos os clientes. O URI do conjunto de entidades de Customers é determinado automaticamente pelo contexto. A consulta é executada implicitamente quando a enumeração ocorre. O serviço de dados Northwind é criado quando você conclui o WCF Data Services .

// Create the DataServiceContext using the service URI.
NorthwindEntities context = new NorthwindEntities(svcUri);

// Define a new query for Customers.
DataServiceQuery<Customer> query = context.Customers;

try
{
    // Enumerate over the query result, which is executed implicitly.
    foreach (Customer customer in query)
    {
        Console.WriteLine("Customer Name: {0}", customer.CompanyName);
    }
}
catch (DataServiceQueryException ex)
{
    throw new ApplicationException(
        "An error occurred during query execution.", ex);
}

' Create the DataServiceContext using the service URI.
Dim context = New NorthwindEntities(svcUri)

' Define a new query for Customers.
Dim query As DataServiceQuery(Of Customer) = context.Customers

Try
    ' Enumerate over the query result, which is executed implicitly.
    For Each customer As Customer In query
        Console.WriteLine("Customer Name: {0}", customer.CompanyName)
    Next
Catch ex As DataServiceQueryException
    Throw New ApplicationException( _
            "An error occurred during query execution.", ex)
End Try

Comentários

WCF Data Services são sem estado, mas o DataServiceContext não é. O estado no cliente é mantido entre interações para dar suporte a recursos como gerenciamento de atualizações. Essa classe e a DataServiceQuery classe que representa uma solicitação HTTP específica para um serviço de dados são as duas classes main na biblioteca de clientes.

Construtores

DataServiceContext(Uri)

Inicializa uma nova instância da classe DataServiceContext com o serviceRoot especificado.

Propriedades

ApplyingChanges	Obtém um valor que indica se o DataServiceContext está atualmente aplicando as alterações aos objetos controlados.
BaseUri	Obtém o URI absoluto identificando a raiz do serviço de dados de destino.
Credentials	Obtém ou define as informações de autenticação usadas por cada consulta criada com o objeto DataServiceContext.
DataNamespace	Obtém ou define o namespace de XML para itens de dados, não itens de metadados, de uma carga de Atom.
Entities	Obtém uma lista de todos os recursos atualmente acompanhados pelo DataServiceContext.
IgnoreMissingProperties	Obtém ou define se as propriedades lidas do tipo devem ser mapeadas para propriedades no tipo do lado do cliente.
IgnoreResourceNotFoundException	Obtém ou define se uma exceção é acionada quando um erro 404 (recurso não encontrado) é retornado pelo serviço de dados.
Links	Obtém a coleção de todas as associações ou links que estão sendo atualmente controlados pelo objeto DataServiceContext.
MergeOption	Obtém ou define a opção de sincronização para o recebimento de entidades de um serviço de dados.
ResolveName	Obtém ou define uma função para substituir a estratégia de resolução de tipo padrão usada pela biblioteca de cliente durante o envio de entidades para um serviço de dados.
ResolveType	Obtém ou define uma função que é usada para substituir a opção de resolução de tipo padrão usada pela biblioteca de cliente durante o recebimento de entidades de um serviço de dados.
SaveChangesDefaultOptions	Obtém ou define os valores SaveChangesOptions usados pelo método SaveChanges().
Timeout	Obtém ou define a opção de tempo limite usada para a solicitação HTTP subjacente para o serviço de dados.
TypeScheme	Obtém ou define o URI usado para indicar qual esquema de tipo é usado pelo serviço.
UsePostTunneling	Obtém ou define um valor booliano que indica se o túnel de postagem deve ser usado.

Métodos

AddLink(Object, String, Object)	Adiciona o link especificado ao conjunto de objetos que DataServiceContext está acompanhando.
AddObject(String, Object)	Adiciona o objeto especificado ao conjunto de objetos que DataServiceContext está acompanhando.
AddRelatedObject(Object, String, Object)	Adiciona um objeto relacionado ao contexto e cria o link que define a relação entre os dois objetos em uma única solicitação.
AttachLink(Object, String, Object)	Notifica o DataServiceContext para começar a acompanhar o link especificado que define uma relação entre objetos de entidade.
AttachTo(String, Object)	Notifica o DataServiceContext para iniciar o acompanhamento do recurso especificado e fornece o local do recurso no conjunto de recursos especificado.
AttachTo(String, Object, String)	Notifica o DataServiceContext para iniciar o acompanhamento do recurso especificado e fornece o local do recurso no conjunto de recursos especificado.
BeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)	Envia de forma assíncrona uma solicitação ao serviço de dados para recuperar a próxima página de dados em um resultado paginado da consulta.
BeginExecute<TElement>(Uri, AsyncCallback, Object)	Envia de forma assíncrona a solicitação, para que essa chamada não bloqueie o processamento enquanto aguarda os resultados do serviço.
BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[])	Envia de forma assíncrona um grupo de consultas como um lote para o serviço de dados.
BeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object)	Obtém de forma assíncrona os dados da propriedade binária para a entidade especificada como um fluxo de dados junto com os cabeçalhos da mensagem especificada.
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.
BeginSaveChanges(AsyncCallback, Object)	Envia de forma assíncrona as alterações pendentes ao serviço de dados coletadas pelo DataServiceContext, desde as últimas alterações salvas.
BeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)	Envia de forma assíncrona as alterações pendentes ao serviço de dados coletadas pelo DataServiceContext, desde as últimas alterações salvas.
CancelRequest(IAsyncResult)	Tenta cancelar a operação associada ao objeto IAsyncResult fornecido.
CreateQuery<T>(String)	Cria uma consulta do serviço de dados para dados de um tipo genérico especificado.
DeleteLink(Object, String, Object)	Altera o estado do link para excluído na lista de links acompanhados pelo DataServiceContext.
DeleteObject(Object)	Altera o estado do objeto especificado a ser excluído no DataServiceContext.
Detach(Object)	Remove a entidade da lista de entidades que o DataServiceContext está acompanhando.
DetachLink(Object, String, Object)	Remove o link especificado na lista de links que estão sendo acompanhados pelo DataServiceContext.
EndExecute<TElement>(IAsyncResult)	Chamado para concluir o BeginExecute<TElement>(Uri, AsyncCallback, Object).
EndExecuteBatch(IAsyncResult)	Chamado para concluir o BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[]).
EndGetReadStream(IAsyncResult)	Chamado para concluir a operação assíncrona de recuperação de uma propriedade binária como um fluxo.
EndLoadProperty(IAsyncResult)	Chamado para concluir a operação BeginLoadProperty(Object, String, AsyncCallback, Object).
EndSaveChanges(IAsyncResult)	Chamado para concluir a operação BeginSaveChanges(AsyncCallback, Object).
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Execute<T>(DataServiceQueryContinuation<T>)	Envia uma solicitação ao serviço de dados para recuperar a próxima página de dados em um resultado paginado da consulta.
Execute<TElement>(Uri)	Envia uma solicitação ao serviço de dados para executar um URI específico.
ExecuteBatch(DataServiceRequest[])	Envia um grupo de consultas como um lote para o serviço de dados.
GetEntityDescriptor(Object)	Obtém o EntityDescriptor para o objeto de entidade fornecido.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLinkDescriptor(Object, String, Object)	Obtém o LinkDescriptor para um link específico que define a relação entre duas entidades.
GetMetadataUri()	Obtém um URI do local dos metadados .edmx.
GetReadStream(Object)	Obtém dados de propriedade binária para a entidade especificada como um fluxo de dados.
GetReadStream(Object, DataServiceRequestArgs)	Obtém os dados de propriedade binária para a entidade especificada como um fluxo de dados junto com os cabeçalhos da mensagem especificada.
GetReadStream(Object, String)	Obtém os dados de propriedade binária para a entidade especificada como um fluxo de dados, com o cabeçalho da mensagem Accept.
GetReadStreamUri(Object)	Obtém o URI usado para retornar dados de propriedade binária como um fluxo de dados.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
LoadProperty(Object, String)	Carrega o conteúdo adiado para uma propriedade especificada do serviço de dados.
LoadProperty(Object, String, DataServiceQueryContinuation)	Carrega a próxima página de entidades relacionadas do serviço de dados usando o objeto de continuação de consulta fornecido.
LoadProperty(Object, String, Uri)	Carrega uma página de entidades relacionadas usando o próximo URI de link fornecido.
LoadProperty<T>(Object, String, DataServiceQueryContinuation<T>)	Carrega a próxima página de entidades relacionadas do serviço de dados usando o objeto de continuação de consulta genérico fornecido.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
SaveChanges()	Salva as alterações que o DataServiceContext está acompanhamento para o armazenamento.
SaveChanges(SaveChangesOptions)	Salva as alterações que o DataServiceContext está acompanhamento para o armazenamento.
SetLink(Object, String, Object)	Notifica o DataServiceContext que existe um novo link entre os objetos especificados e que o link é representado pela propriedade especificada pelo parâmetro sourceProperty.
SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)	Define um novo fluxo de dados como a propriedade binária de uma entidade, com as configurações especificadas na mensagem de solicitação.
SetSaveStream(Object, Stream, Boolean, String, String)	Define um novo fluxo de dados como a propriedade binária de uma entidade. Os cabeçalhos Content-Type e Slug especificados são incluídos na mensagem de solicitação.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TryGetEntity<TEntity>(Uri, TEntity)	Testa a recuperação de uma entidade que está sendo acompanhada pelo DataServiceContext por referência ao URI da entidade.
TryGetUri(Object, Uri)	Recupera o URI canônico associado à entidade especificada, se disponível.
UpdateObject(Object)	Altera o estado do objeto especificado no DataServiceContext para Modified.

Eventos

ReadingEntity	Ocorre depois que os dados de entidade foram lidos por completo no objeto de entidade.
SendingRequest	Ocorre quando um novo HttpWebRequest foi criado.
WritingEntity	Ocorre depois que uma entidade foi totalmente serializada em XML em uma mensagem de solicitação.

Confira também

• Trabalhando com bibliotecas de cliente .NET Framework (WCF Data Services)