DataServiceContext Classe

Definição

Espaço de Nomes:
System.Data.Services.Client
Assemblagem:
System.Data.Services.Client.dll

O DataServiceContext representa o contexto de execução 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 seguinte mostra como usar a DataServiceContext ferramenta gerada pela Adicionar Referência de Serviço para executar implicitamente uma consulta ao serviço de dados da Northwind que devolve todos os clientes. O URI do conjunto de entidades solicitado Customers é determinado automaticamente pelo contexto. A consulta é executada implicitamente quando ocorre a enumeração. O serviço de dados Northwind é criado quando se completa 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

Observações

Os Serviços de Dados WCF são sem estado, mas o DataServiceContext não é. O estado no cliente é mantido entre interações para suportar funcionalidades como a gestão de atualizações. Esta classe, e a DataServiceQuery classe que representa um pedido HTTP particular a um serviço de dados, são as duas principais classes na biblioteca cliente.

Construtores

Name Description
DataServiceContext(Uri)

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

Propriedades

Name Description
ApplyingChanges

Recebe um valor que indica se está DataServiceContext atualmente a aplicar alterações aos objetos rastreados.
BaseUri

Obtém o URI absoluto que identifica a raiz do serviço de dados alvo.
Credentials

Obtém ou define a informação de autenticação que é usada por cada consulta criada pelo uso do DataServiceContext objeto.
DataNamespace

Obtém ou define o espaço de nomes XML para itens de dados, não metadados, de uma carga útil Atom.
Entities

Obtém uma lista de todos os recursos atualmente monitorizados 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 é levantada quando um erro 404 (recurso não encontrado) é devolvido pelo serviço de dados.
Links

Obtém a coleção de todas as associações ou links que estão a ser rastreados pelo DataServiceContext objeto.
MergeOption

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

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

Recebe ou define uma função que é usada para substituir a opção padrão de resolução de tipos usada pela biblioteca cliente ao receber entidades de um serviço de dados.
SaveChangesDefaultOptions

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

Recebe ou define a opção de time-out que é usada para o pedido HTTP subjacente ao serviço de dados.
TypeScheme

Obtém ou define o URI usado para indicar qual o esquema de tipos utilizado pelo serviço.
UsePostTunneling

Recebe ou define um valor booleano que indica se deve usar post tunelamento.

Métodos

Name Description
AddLink(Object, String, Object)

Adiciona a ligação especificada ao conjunto de objetos que DataServiceContext está a rastrear.
AddObject(String, Object)

Adiciona o objeto especificado ao conjunto de objetos que o DataServiceContext está a seguir.
AddRelatedObject(Object, String, Object)

Adiciona um objeto relacionado ao contexto e cria a ligação que define a relação entre os dois objetos num único pedido.
AttachLink(Object, String, Object)

Notifica o DataServiceContext para começar a rastrear a ligação especificada que define uma relação entre objetos entidade.
AttachTo(String, Object, String)

Notifica para DataServiceContext começar a rastrear o recurso especificado e fornece a localização do recurso no conjunto de recursos especificado.
AttachTo(String, Object)

Notifica-o DataServiceContext para começar a acompanhar o recurso especificado e fornece a localização do recurso dentro do conjunto de recursos especificado.
BeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)

De forma assíncrona, envia um pedido ao serviço de dados para recuperar a página seguinte de dados num resultado de consulta paginada.
BeginExecute<TElement>(Uri, AsyncCallback, Object)

Envia o pedido de forma assíncrona para que esta chamada não bloqueie o processamento enquanto aguarda os resultados do serviço.
BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[])

Submete de forma assíncrona um grupo de consultas em lote ao serviço de dados.
BeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object)

De forma assíncrona, obtém dados de propriedades binárias para a entidade especificada como um fluxo de dados juntamente com os cabeçalhos de mensagem especificados.
BeginLoadProperty(Object, String, AsyncCallback, Object)

Carrega assíncronamente o valor da propriedade especificada a partir do serviço de dados.
BeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object)

Carrega assíncronamente a página seguinte das entidades relacionadas a partir do serviço de dados usando o objeto de continuação da consulta fornecido.
BeginLoadProperty(Object, String, Uri, AsyncCallback, Object)

Carrega assíncronamente uma página de entidades relacionadas a partir do serviço de dados usando o URI do próximo link fornecido.
BeginSaveChanges(AsyncCallback, Object)

Submete assíncronamente as alterações pendentes ao serviço de dados recolhidas pelo DataServiceContext desde a última vez que as alterações foram guardadas.
BeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)

Submete assíncronamente as alterações pendentes ao serviço de dados recolhidas pelo DataServiceContext desde a última vez que as alterações foram guardadas.
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 eliminado na lista de links que estão a ser rastreados pelo DataServiceContext.
DeleteObject(Object)

Altera o estado do objeto especificado a ser eliminado no DataServiceContext.
Detach(Object)

Remove a entidade da lista de entidades que está DataServiceContext a acompanhar.
DetachLink(Object, String, Object)

Remove o link especificado da lista de links rastreados pelo DataServiceContext.
EndExecute<TElement>(IAsyncResult)

Chamado para completar o BeginExecute<TElement>(Uri, AsyncCallback, Object).
EndExecuteBatch(IAsyncResult)

Chamado para completar o BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[]).
EndGetReadStream(IAsyncResult)

Chamado para completar a operação assíncrona de recuperar uma propriedade binária como 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 um pedido ao serviço de dados para recuperar a página seguinte de dados num resultado de consulta paginada.
Execute<TElement>(Uri)

Envia um pedido ao serviço de dados para executar um URI específico.
ExecuteBatch(DataServiceRequest[])

Submete um grupo de consultas em lote ao serviço de dados.
GetEntityDescriptor(Object)

Obtém o EntityDescriptor para o objeto da entidade fornecida.
GetHashCode()

Serve como função de hash predefinida.

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

Obtém-se para LinkDescriptor uma ligação específica que define a relação entre duas entidades.
GetMetadataUri()

Obtém um URI da localização dos metadados .edmx.
GetReadStream(Object, DataServiceRequestArgs)

Obtém dados de propriedades binárias para a entidade especificada como um fluxo de dados juntamente 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 da mensagem Accept especificado.
GetReadStream(Object)

Obtém dados de propriedades binárias para a entidade especificada como um fluxo de dados.
GetReadStreamUri(Object)

Obtém o URI que é usado para devolver dados de propriedades binárias como fluxo de dados.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
LoadProperty(Object, String, DataServiceQueryContinuation)

Carrega a página seguinte das entidades relacionadas a partir do serviço de dados usando o objeto de continuação da consulta fornecido.
LoadProperty(Object, String, Uri)

Carrega uma página de entidades relacionadas usando o URI do link seguinte fornecido.
LoadProperty(Object, String)

Carrega conteúdo diferido para uma propriedade especificada do serviço de dados.
LoadProperty<T>(Object, String, DataServiceQueryContinuation<T>)

Carrega a página seguinte das entidades relacionadas a partir do serviço de dados usando o objeto genérico de continuação da consulta fornecido.
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
SaveChanges()

Guarda as alterações que está DataServiceContext a registar no armazenamento.
SaveChanges(SaveChangesOptions)

Guarda as alterações que está DataServiceContext a registar no armazenamento.
SetLink(Object, String, Object)

Notifica que DataServiceContext existe uma nova ligação entre os objetos especificados e que a ligação é representada pela propriedade especificada pelo sourceProperty parâmetro.
SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)

Define um novo fluxo de dados como propriedade binária de uma entidade, com as definições especificadas na mensagem de pedido.
SetSaveStream(Object, Stream, Boolean, String, String)

Define um novo fluxo de dados como propriedade binária de uma entidade. Os cabeçalhos Type-Content-Type e Slug especificados estão incluídos na mensagem de pedido.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
TryGetEntity<TEntity>(Uri, TEntity)

Recuperação de teste de uma entidade que está a ser rastreada por referência DataServiceContext 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 em para DataServiceContextModified.

evento

Name Description
ReadingEntity

Ocorre depois de os dados da entidade terem sido completamente lidos no objeto da entidade.
SendingRequest

Ocorre quando um novo HttpWebRequest foi criado.
WritingEntity

Ocorre depois de uma entidade ter sido totalmente serializada em XML numa mensagem de pedido.

Aplica-se a

Ver também