Condividi tramite

Classe DataServiceContext

  • Articolo

DataServiceContext rappresenta il contesto di runtime del servizio dati.

Gerarchia di ereditarietà

System.Object
  System.Data.Services.Client.DataServiceContext

Spazio dei nomi  System.Data.Services.Client
Assembly:  Microsoft.Data.Services.Client (in Microsoft.Data.Services.Client.dll)

Sintassi

'Dichiarazione
Public Class DataServiceContext
'Utilizzo
Dim instance As DataServiceContext

public class DataServiceContext

public ref class DataServiceContext

type DataServiceContext =  class end

public class DataServiceContext

Nel tipo DataServiceContext sono esposti i membri seguenti.

Costruttori

  Nome Descrizione
Metodo pubblico DataServiceContext() Inizializza una nuova istanza della classe DataServiceContext.
Metodo pubblico DataServiceContext(Uri) Inizializza una nuova istanza della classe DataServiceContext con l'oggetto serviceRoot specificato.
Metodo pubblico DataServiceContext(Uri, DataServiceProtocolVersion) Inizializza una nuova istanza della classe DataServiceContext con l'oggetto serviceRoot specificato e destinata all'oggetto maxProtocolVersion specifico.

In alto

Proprietà

  Nome Descrizione
Proprietà pubblica AddAndUpdateResponsePreference Ottiene o imposta un valore che indica se il client richiede che il servizio dati restituisca dati di entità nel messaggio di risposta a una richiesta di modifica.
Proprietà pubblica ApplyingChanges Ottiene un valore che indica se l'oggetto DataServiceContext è in fase di applicazione di modifiche agli oggetti rilevati.
Proprietà pubblica BaseUri Ottiene l'URI assoluto che identifica la radice del servizio dati di destinazione.
Proprietà pubblica Credentials Ottiene o imposta le informazioni di autenticazione utilizzate da ogni query creata tramite l'oggetto DataServiceContext.
Proprietà pubblica DataNamespace Ottiene o imposta lo spazio dei nomi XML per elementi di dati (non elementi di metadati) di un payload Atom.
Proprietà pubblica Entities Ottiene un elenco di tutte le risorse attualmente rilevate da DataServiceContext.
Proprietà pubblica HttpStack Ottiene un valore che indica il tipo di implementazione HTTP da utilizzare quando si accede al servizio dati.Supportato unicamente dal client di WCF Data Services 5.0 per Silverlight.
Proprietà pubblica IgnoreMissingProperties Ottiene o imposta un valore che indica se è necessario eseguire il mapping delle proprietà lette dal tipo alle proprietà nel tipo lato client.
Proprietà pubblica IgnoreResourceNotFoundException Ottiene o imposta un valore che indica se viene generata un'eccezione in caso di restituzione di un errore 404 (risorsa non trovata) da parte del servizio dati.
Proprietà pubblica Links Ottiene la raccolta di tutte le associazioni o di tutti i collegamenti attualmente rilevati tramite l'oggetto DataServiceContext.
Proprietà pubblica MaxProtocolVersion Ottiene la versione massima di OData (Open Data Protocol) che il client può utilizzare.
Proprietà pubblica MergeOption Ottiene o imposta l'opzione di sincronizzazione per la ricezione di entità da un servizio dati.
Proprietà pubblica ResolveEntitySet Ottiene o imposta il metodo delegato utilizzato per risolvere l'URI del set di entità se non è possibile determinare il valore da un URI edit-link o self-link.
Proprietà pubblica ResolveName Ottiene o imposta una funzione per eseguire l'override della strategia di risoluzione del tipo predefinita utilizzata dalla libreria client in caso di invio di entità a un servizio dati.
Proprietà pubblica ResolveType Ottiene o imposta una funzione utilizzata per eseguire l'override dell'opzione di risoluzione del tipo predefinita utilizzata dalla libreria client in caso di ricezione di entità da un servizio dati.
Proprietà pubblica SaveChangesDefaultOptions Ottiene o imposta i valori SaveChangesOptions utilizzati dal metodo SaveChanges.
Proprietà pubblica Timeout Ottiene o imposta l'opzione di timeout (in secondi) utilizzata per la richiesta HTTP sottostante al servizio dati.
Proprietà pubblica TypeScheme Ottiene o imposta l'URI utilizzato per indicare lo schema del tipo utilizzato dal servizio.
Proprietà pubblica UseDefaultCredentials Ottiene o imposta un valore che indica se vengono utilizzate le credenziali predefinite per autenticare le richieste al servizio dati. Supportato unicamente dal client di WCF Data Services 5.0 per Silverlight.
Proprietà pubblica UsePostTunneling Ottiene o imposta un valore booleano che indica se utilizzare il post tunneling.

In alto

Metodi

  Nome Descrizione
Metodo pubblico AddLink Aggiunge il collegamento specificato al set di oggetti rilevato da DataServiceContext.
Metodo pubblico AddObject Aggiunge l'oggetto specificato al set di oggetti rilevato da DataServiceContext.
Metodo pubblico AddRelatedObject Aggiunge un oggetto correlato al contesto e crea il collegamento che definisce la relazione tra i due oggetti in una singola richiesta.
Metodo pubblico AttachLink Notifica a DataServiceContext di iniziare a rilevare il collegamento specificato che definisce una relazione tra oggetti entità.
Metodo pubblico AttachTo(String, Object) Notifica a DataServiceContext di iniziare a rilevare la risorsa specificata e fornisce il percorso della risorsa all'interno del set di risorse specificato.
Metodo pubblico AttachTo(String, Object, String) Notifica a DataServiceContext di iniziare a rilevare la risorsa specificata e fornisce il percorso della risorsa nel set di risorse specificato.
Metodo pubblico BeginExecute(Uri, AsyncCallback, Object, String, array<OperationParameter[]) Invia in modo asincrono una richiesta al servizio dati per eseguire un URI specifico.
Metodo pubblico BeginExecute<TElement>(Uri, AsyncCallback, Object) Invia in modo asincrono la richiesta in modo che questa chiamata non blocchi l'elaborazione mentre è in attesa dei risultati dal servizio.
Metodo pubblico BeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object) Invia in modo asincrono una richiesta al servizio dati per recuperare la pagina di dati successiva in un risultato di query di cui è stato eseguito il paging.
Metodo pubblico BeginExecute<TElement>(Uri, AsyncCallback, Object, String, Boolean, array<OperationParameter[]) Invia in modo asincrono una richiesta al servizio dati per eseguire un URI specifico.
Metodo pubblico BeginExecuteBatch Invia in modo asincrono un gruppo di query come batch al servizio dati.
Metodo pubblico BeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object) Ottiene in modo asincrono il flusso di dati binari appartenente all'entità specificata tramite le intestazioni di messaggio specificate.
Metodo pubblico BeginGetReadStream(Object, String, DataServiceRequestArgs, AsyncCallback, Object) Ottiene in modo asincrono un flusso di dati binari denominato appartenente all'entità specificata tramite le intestazioni di messaggio specificate.
Metodo pubblico BeginLoadProperty(Object, String, AsyncCallback, Object) Carica in modo asincrono il valore della proprietà specificata dal servizio dati.
Metodo pubblico BeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object) Carica in modo asincrono la pagina successiva di entità correlate dal servizio dati tramite l'oggetto di continuazione di query fornito.
Metodo pubblico BeginLoadProperty(Object, String, Uri, AsyncCallback, Object) Carica in modo asincrono una pagina di entità correlate dal servizio dati tramite l'URI del collegamento successivo fornito.
Metodo pubblico BeginSaveChanges(AsyncCallback, Object) Invia in modo asincrono al servizio dati le modifiche in sospeso raccolte da DataServiceContext dall'ultimo salvataggio delle modifiche.
Metodo pubblico BeginSaveChanges(SaveChangesOptions, AsyncCallback, Object) Invia in modo asincrono al servizio dati le modifiche in sospeso raccolte da DataServiceContext dall'ultimo salvataggio delle modifiche.
Metodo pubblico CancelRequest Tenta di annullare l'operazione associata all'oggetto IAsyncResult fornito.
Metodo pubblico CreateQuery<T> Crea una query del servizio dati per i dati di un tipo generico specificato.
Metodo pubblico DeleteLink Modifica lo stato del collegamento in eliminato nell'elenco di collegamenti rilevati da DataServiceContext.
Metodo pubblico DeleteObject Modifica lo stato dell'oggetto specificato da eliminare in DataServiceContext.
Metodo pubblico Detach Rimuove l'entità dall'elenco di entità rilevato da DataServiceContext.
Metodo pubblico DetachLink Rimuove il collegamento specificato dall'elenco dei collegamenti rilevati da DataServiceContext.
Metodo pubblico EndExecute(IAsyncResult) Chiamato per completare il metodo BeginExecute.
Metodo pubblico EndExecute<TElement>(IAsyncResult) Chiamato per completare il metodo BeginExecute.
Metodo pubblico EndExecuteBatch Chiamato per completare il metodo BeginExecuteBatch.
Metodo pubblico EndGetReadStream Chiamato per completare l'operazione asincrona di recupero di un flusso di dati binari.
Metodo pubblico EndLoadProperty Chiamato per completare l'operazione BeginLoadProperty.
Metodo pubblico EndSaveChanges Chiamato per completare l'operazione BeginSaveChanges.
Metodo pubblico Equals Ereditato da Object.
Metodo pubblico Execute(Uri, String, array<OperationParameter[]) Invia una richiesta al servizio dati per eseguire un URI specifico utilizzando un metodo HTTP specifico.Non supportato dal client di WCF Data Services 5.0 per Silverlight.
Metodo pubblico Execute<TElement>(Uri) Invia una richiesta al servizio dati per eseguire un URI specifico.Non supportato dal client di WCF Data Services 5.0 per Silverlight.
Metodo pubblico Execute<T>(DataServiceQueryContinuation<T>) Invia una richiesta al servizio dati per recuperare la pagina di dati successiva in un risultato di query di cui è stato eseguito il paging.Non supportato dal client di WCF Data Services 5.0 per Silverlight.
Metodo pubblico Execute<TElement>(Uri, String, Boolean, array<OperationParameter[]) Invia una richiesta al servizio dati per eseguire un URI specifico utilizzando un metodo HTTP specifico.Non supportato dal client di WCF Data Services 5.0 per Silverlight.
Metodo pubblico ExecuteBatch Invia in modo sincrono un gruppo di query come batch al servizio dati.Non supportato dal client di WCF Data Services 5.0 per Silverlight.
Metodo protetto Finalize Ereditato da Object.
Metodo pubblico GetEntityDescriptor Ottiene l'oggetto EntityDescriptor per l'oggetto entità fornito.
Metodo pubblico GetHashCode Ereditato da Object.
Metodo pubblico GetLinkDescriptor Ottiene l'oggetto LinkDescriptor per un collegamento specifico che definisce la relazione tra due entità.
Metodo pubblico GetMetadataUri Ottiene un URI del percorso dei metadati con estensione edmx.
Metodo pubblico GetReadStream(Object) Ottiene il flusso di dati binari appartenente all'entità specificata.Non supportato dal client di WCF Data Services 5.0 per Silverlight.
Metodo pubblico GetReadStream(Object, DataServiceRequestArgs) Ottiene il flusso di dati binari per l'entità specificata tramite le intestazioni di messaggio specificate.Non supportato dal client di WCF Data Services 5.0 per Silverlight.
Metodo pubblico GetReadStream(Object, String) Ottiene il flusso di dati binari appartenente all'entità specificata tramite l'intestazione di messaggio Content-Type specificata.Non supportato dal client di WCF Data Services 5.0 per Silverlight.
Metodo pubblico GetReadStream(Object, String, DataServiceRequestArgs) Ottiene uno flusso di dati binari denominato appartenente all'entità specificata tramite l'intestazione di messaggio Content-Type specificata.Non supportato dal client di WCF Data Services 5.0 per Silverlight.
Metodo pubblico GetReadStreamUri(Object) Ottiene l'URI utilizzato per restituire un flusso di dati binari.
Metodo pubblico GetReadStreamUri(Object, String) Ottiene l'URI utilizzato per restituire un flusso di dati binari denominato.
Metodo pubblico GetType Ereditato da Object.
Metodo pubblico LoadProperty(Object, String) Carica il contenuto posticipato per una proprietà specificata dal servizio dati.Non supportato dal client di WCF Data Services 5.0 per Silverlight.
Metodo pubblico LoadProperty(Object, String, DataServiceQueryContinuation) Carica la pagina successiva di entità correlate dal servizio dati tramite l'oggetto di continuazione di query fornito.Non supportato dal client di WCF Data Services 5.0 per Silverlight.
Metodo pubblico LoadProperty(Object, String, Uri) Carica una pagina di entità correlate tramite l'URI del collegamento successivo fornito.Non supportato dal client di WCF Data Services 5.0 per Silverlight.
Metodo pubblico LoadProperty<T>(Object, String, DataServiceQueryContinuation<T>) Carica la pagina successiva di entità correlate dal servizio dati tramite l'oggetto generico di continuazione di query fornito.Non supportato dal client di WCF Data Services 5.0 per Silverlight.
Metodo protetto MemberwiseClone Ereditato da Object.
Metodo pubblico SaveChanges() Salva le modifiche rilevate da DataServiceContext per l'archiviazione.Non supportato dal client di WCF Data Services 5.0 per Silverlight.
Metodo pubblico SaveChanges(SaveChangesOptions) Salva le modifiche rilevate da DataServiceContext per l'archiviazione.Non supportato dal client di WCF Data Services 5.0 per Silverlight.
Metodo pubblico SetLink Notifica a DataServiceContext l'esistenza di un nuovo collegamento tra gli oggetti specificati e la rappresentazione del collegamento da parte della proprietà specificata dal parametro sourceProperty.
Metodo pubblico SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs) Imposta un flusso di dati binari per l'entità specificata con le intestazioni specificate nel messaggio di richiesta.
Metodo pubblico SetSaveStream(Object, Stream, Boolean, String, String) Imposta un flusso di dati binari appartenente all'entità specificata con le intestazioni Content-Type e Slug specificate nel messaggio di richiesta.
Metodo pubblico SetSaveStream(Object, String, Stream, Boolean, DataServiceRequestArgs) Imposta un flusso di dati binari denominato appartenente all'entità specificata con le intestazioni specificate nel messaggio di richiesta.
Metodo pubblico SetSaveStream(Object, String, Stream, Boolean, String) Imposta un flusso di dati binari per l'entità specificata.
Metodo pubblico ToString Ereditato da Object.
Metodo pubblico TryGetEntity<TEntity> Recupero di prova di un'entità rilevata da DataServiceContext per riferimento all'URI dell'entità.
Metodo pubblico TryGetUri Recupera l'URI canonico associato all'entità specificata, se disponibile.
Metodo pubblico UpdateObject Modifica in Modified lo stato dell'oggetto specificato in DataServiceContext.

In alto

Eventi

  Nome Descrizione
Evento pubblico ReadingEntity Si verifica dopo che i dati dell'entità sono stati completamente letti nell'oggetto entità.
Evento pubblico SendingRequest Si verifica in caso di creazione di un nuovo oggetto HttpWebRequest.
Evento pubblico SendingRequest2 Si verifica in caso di creazione di un nuovo oggetto HttpWebRequest.
Evento pubblico WritingEntity Si verifica dopo che un'entità è stata completamente serializzata in XML in un messaggio di richiesta.

In alto

Osservazioni

WCF Data Services è senza stato, a differenza di DataServiceContext. Lo stato nel client viene mantenuto tra le interazioni per supportare funzionalità quali la gestione degli aggiornamenti. Questa classe e la classe DataServiceQuery che rappresenta una particolare richiesta HTTP a un servizio dati sono le due classi principali nella libreria client.

Esempi

Nell'esempio seguente viene illustrato come utilizzare l'oggetto DataServiceContext generato dallo strumento Aggiungi riferimento al servizio per eseguire in modo implicito una query sul servizio dati Northwind che restituisce tutti i clienti. L'URI del set di entità Customers richiesto viene determinato automaticamente dal contesto. La query viene eseguita in modo implicito quando si verifica l'enumerazione. Il servizio dati Northwind viene creato al completamento della Guida rapida di WCF Data Services.

' 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

// 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);
}

Protezione dei thread

I membri static (Shared in Visual Basic) pubblici di questo tipo sono affidabili. Non è invece garantita la sicurezza dei membri dell'istanza.

Vedere anche

Riferimento

Spazio dei nomi System.Data.Services.Client

Altre risorse

Client dati (WCF Data Services)