DataServiceContext Classe

Definição

Namespace:
System.Data.Services.Client
Assembly:
System.Data.Services.Client.dll

Representa DataServiceContext o contexto de 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 solicitado Customers é determinado automaticamente pelo contexto. A consulta é executada implicitamente quando a enumeração ocorre. O serviço de dados Northwind é criado quando você conclui os Serviços de Dados do WCF.

// 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

Os Serviços de Dados do WCF são sem estado, mas não DataServiceContext sã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 principais na biblioteca de clientes.

Construtores

Nome Description
DataServiceContext(Uri)

Inicializa uma nova instância da DataServiceContext classe com a especificada serviceRoot.

Propriedades

Nome Description
ApplyingChanges

Obtém um valor que indica se o DataServiceContext momento está aplicando alterações a objetos rastreados.
BaseUri

Obtém o URI absoluto que identifica 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 usando o DataServiceContext objeto.
DataNamespace

Obtém ou define o namespace XML para itens de dados, não itens de metadados, de uma carga Atom.
Entities

Obtém uma lista de todos os recursos que estão sendo rastreados 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 é gerada 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 rastreados pelo DataServiceContext objeto no momento.
MergeOption

Obtém ou define a opção de sincronização para receber entidades de um serviço de dados.
ResolveName

Obtém ou define uma função para substituir a estratégia de resolução de tipos padrão usada pela biblioteca de clientes quando você envia entidades para um serviço de dados.
ResolveType

Obtém ou define uma função usada para substituir a opção de resolução de tipo padrão usada pela biblioteca de clientes ao receber entidades de um serviço de dados.
SaveChangesDefaultOptions

Obtém ou define os SaveChangesOptions valores usados pelo SaveChanges() método.
Timeout

Obtém ou define a opção de tempo limite que é 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 deve usar o túnel pós-túnel.

Métodos

Nome Description
AddLink(Object, String, Object)

Adiciona o link especificado ao conjunto de objetos que o DataServiceContext está acompanhando.
AddObject(String, Object)

Adiciona o objeto especificado ao conjunto de objetos que o 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 a origem do DataServiceContext acompanhamento do link especificado que define uma relação entre objetos de entidade.
AttachTo(String, Object, String)

Notifica a origem do DataServiceContext acompanhamento do recurso especificado e fornece o local do recurso no conjunto de recursos especificado.
AttachTo(String, Object)

Notifica o para começar a DataServiceContext acompanhar o recurso especificado e fornece o local do recurso dentro do 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 de consulta paginado.
BeginExecute<TElement>(Uri, AsyncCallback, Object)

Envia a solicitação de forma assíncrona 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 dados de propriedade binária para a entidade especificada como um fluxo de dados junto com os cabeçalhos de mensagem especificados.
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 as alterações pendentes de forma assíncrona ao serviço de dados coletado pela DataServiceContext última vez em que as alterações foram salvas.
BeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)

Envia as alterações pendentes de forma assíncrona ao serviço de dados coletado pela DataServiceContext última vez em que as alterações foram salvas.
CancelRequest(IAsyncResult)

Tenta cancelar a operação associada ao objeto fornecido IAsyncResult .
CreateQuery<T>(String)

Cria uma consulta de 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 que estão sendo 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 da lista de links que estão sendo rastreados 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 BeginLoadProperty(Object, String, AsyncCallback, Object) operação.
EndSaveChanges(IAsyncResult)

Chamado para concluir a BeginSaveChanges(AsyncCallback, Object) operação.
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 de consulta paginado.
Execute<TElement>(Uri)

Envia uma solicitação para o 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 objeto de entidade fornecido.
GetHashCode()

Serve como a função hash predefinida.

(Herdado de Object)
GetLinkDescriptor(Object, String, Object)

Obtém o LinkDescriptor link específico que define a relação entre duas entidades.
GetMetadataUri()

Obtém um URI do local dos metadados .edmx.
GetReadStream(Object, DataServiceRequestArgs)

Obtém dados de propriedade binária para a entidade especificada como um fluxo de dados junto com os cabeçalhos de mensagem especificados.
GetReadStream(Object, String)

Obtém dados de propriedade binária para a entidade especificada como um fluxo de dados, com o cabeçalho de mensagem Accept especificado.
GetReadStream(Object)

Obtém dados de propriedade binária para a entidade especificada como um fluxo de dados.
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, 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(Object, String)

Carrega conteúdo adiado para uma propriedade especificada do serviço de dados.
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 Objectatual.

(Herdado de Object)
SaveChanges()

Salva as alterações que o DataServiceContext rastreamento está acompanhando no armazenamento.
SaveChanges(SaveChangesOptions)

Salva as alterações que o DataServiceContext rastreamento está acompanhando no armazenamento.
SetLink(Object, String, Object)

Notifica que DataServiceContext existe um novo vínculo entre os objetos especificados e que o link é representado pela propriedade especificada pelo sourceProperty parâmetro.
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)

Teste a recuperação de uma entidade que está sendo controlada pela DataServiceContext 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

Nome Description
ReadingEntity

Ocorre depois que os dados da entidade são completamente lidos no objeto de entidade.
SendingRequest

Ocorre quando um novo HttpWebRequest foi criado.
WritingEntity

Ocorre depois que uma entidade é totalmente serializada em XML em uma mensagem de solicitação.

Aplica-se a

Confira também