MSDN Library
Comprimi il sommario
Espandi il sommario
Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe DataServiceContext

DataServiceContext rappresenta il contesto di runtime del servizio dati.

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)

public class DataServiceContext

Nel tipo DataServiceContext sono esposti i membri seguenti.

  NomeDescrizione
Metodo pubblicoDataServiceContext()Inizializza una nuova istanza della classe DataServiceContext.
Metodo pubblicoDataServiceContext(Uri)Inizializza una nuova istanza della classe DataServiceContext con l'oggetto serviceRoot specificato.
Metodo pubblicoDataServiceContext(Uri, DataServiceProtocolVersion)Inizializza una nuova istanza della classe DataServiceContext con l'oggetto serviceRoot specificato e destinata all'oggetto maxProtocolVersion specifico.
In alto

  NomeDescrizione
Proprietà pubblicaAddAndUpdateResponsePreferenceOttiene 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à pubblicaApplyingChangesOttiene un valore che indica se l'oggetto DataServiceContext è in fase di applicazione di modifiche agli oggetti rilevati.
Proprietà pubblicaBaseUriOttiene l'URI assoluto che identifica la radice del servizio dati di destinazione.
Proprietà pubblicaCredentialsOttiene o imposta le informazioni di autenticazione utilizzate da ogni query creata tramite l'oggetto DataServiceContext.
Proprietà pubblicaDataNamespaceOttiene o imposta lo spazio dei nomi XML per elementi di dati (non elementi di metadati) di un payload Atom.
Proprietà pubblicaEntitiesOttiene un elenco di tutte le risorse attualmente rilevate da DataServiceContext.
Proprietà pubblicaHttpStackOttiene 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à pubblicaIgnoreMissingPropertiesOttiene o imposta un valore che indica se è necessario eseguire il mapping delle proprietà lette dal tipo alle proprietà nel tipo lato client.
Proprietà pubblicaIgnoreResourceNotFoundExceptionOttiene 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à pubblicaLinksOttiene la raccolta di tutte le associazioni o di tutti i collegamenti attualmente rilevati tramite l'oggetto DataServiceContext.
Proprietà pubblicaMaxProtocolVersionOttiene la versione massima di OData (Open Data Protocol) che il client può utilizzare.
Proprietà pubblicaMergeOptionOttiene o imposta l'opzione di sincronizzazione per la ricezione di entità da un servizio dati.
Proprietà pubblicaResolveEntitySetOttiene 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à pubblicaResolveNameOttiene 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à pubblicaResolveTypeOttiene 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à pubblicaSaveChangesDefaultOptionsOttiene o imposta i valori SaveChangesOptions utilizzati dal metodo SaveChanges.
Proprietà pubblicaTimeoutOttiene o imposta l'opzione di timeout (in secondi) utilizzata per la richiesta HTTP sottostante al servizio dati.
Proprietà pubblicaTypeSchemeOttiene o imposta l'URI utilizzato per indicare lo schema del tipo utilizzato dal servizio.
Proprietà pubblicaUseDefaultCredentialsOttiene 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à pubblicaUsePostTunnelingOttiene o imposta un valore booleano che indica se utilizzare il post tunneling.
In alto

  NomeDescrizione
Metodo pubblicoAddLinkAggiunge il collegamento specificato al set di oggetti rilevato da DataServiceContext.
Metodo pubblicoAddObjectAggiunge l'oggetto specificato al set di oggetti rilevato da DataServiceContext.
Metodo pubblicoAddRelatedObjectAggiunge un oggetto correlato al contesto e crea il collegamento che definisce la relazione tra i due oggetti in una singola richiesta.
Metodo pubblicoAttachLinkNotifica a DataServiceContext di iniziare a rilevare il collegamento specificato che definisce una relazione tra oggetti entità.
Metodo pubblicoAttachTo(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 pubblicoAttachTo(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 pubblicoBeginExecute(Uri, AsyncCallback, Object, String, OperationParameter[])Invia in modo asincrono una richiesta al servizio dati per eseguire un URI specifico.
Metodo pubblicoBeginExecute<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 pubblicoBeginExecute<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 pubblicoBeginExecute<TElement>(Uri, AsyncCallback, Object, String, Boolean, OperationParameter[])Invia in modo asincrono una richiesta al servizio dati per eseguire un URI specifico.
Metodo pubblicoBeginExecuteBatchInvia in modo asincrono un gruppo di query come batch al servizio dati.
Metodo pubblicoBeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object)Ottiene in modo asincrono il flusso di dati binari appartenente all'entità specificata tramite le intestazioni di messaggio specificate.
Metodo pubblicoBeginGetReadStream(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 pubblicoBeginLoadProperty(Object, String, AsyncCallback, Object)Carica in modo asincrono il valore della proprietà specificata dal servizio dati.
Metodo pubblicoBeginLoadProperty(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 pubblicoBeginLoadProperty(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 pubblicoBeginSaveChanges(AsyncCallback, Object)Invia in modo asincrono al servizio dati le modifiche in sospeso raccolte da DataServiceContext dall'ultimo salvataggio delle modifiche.
Metodo pubblicoBeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)Invia in modo asincrono al servizio dati le modifiche in sospeso raccolte da DataServiceContext dall'ultimo salvataggio delle modifiche.
Metodo pubblicoCancelRequestTenta di annullare l'operazione associata all'oggetto IAsyncResult fornito.
Metodo pubblicoCreateQuery<T>Crea una query del servizio dati per i dati di un tipo generico specificato.
Metodo pubblicoDeleteLinkModifica lo stato del collegamento in eliminato nell'elenco di collegamenti rilevati da DataServiceContext.
Metodo pubblicoDeleteObjectModifica lo stato dell'oggetto specificato da eliminare in DataServiceContext.
Metodo pubblicoDetachRimuove l'entità dall'elenco di entità rilevato da DataServiceContext.
Metodo pubblicoDetachLinkRimuove il collegamento specificato dall'elenco dei collegamenti rilevati da DataServiceContext.
Metodo pubblicoEndExecute(IAsyncResult)Chiamato per completare il metodo BeginExecute.
Metodo pubblicoEndExecute<TElement>(IAsyncResult)Chiamato per completare il metodo BeginExecute.
Metodo pubblicoEndExecuteBatchChiamato per completare il metodo BeginExecuteBatch.
Metodo pubblicoEndGetReadStreamChiamato per completare l'operazione asincrona di recupero di un flusso di dati binari.
Metodo pubblicoEndLoadPropertyChiamato per completare l'operazione BeginLoadProperty.
Metodo pubblicoEndSaveChangesChiamato per completare l'operazione BeginSaveChanges.
Metodo pubblicoEquals Ereditato da Object.
Metodo pubblicoExecute(Uri, String, 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 pubblicoExecute<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 pubblicoExecute<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 pubblicoExecute<TElement>(Uri, String, Boolean, 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 pubblicoExecuteBatchInvia 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 protettoFinalize Ereditato da Object.
Metodo pubblicoGetEntityDescriptorOttiene l'oggetto EntityDescriptor per l'oggetto entità fornito.
Metodo pubblicoGetHashCode Ereditato da Object.
Metodo pubblicoGetLinkDescriptorOttiene l'oggetto LinkDescriptor per un collegamento specifico che definisce la relazione tra due entità.
Metodo pubblicoGetMetadataUriOttiene un URI del percorso dei metadati con estensione edmx.
Metodo pubblicoGetReadStream(Object)Ottiene il flusso di dati binari appartenente all'entità specificata.Non supportato dal client di WCF Data Services 5.0 per Silverlight.
Metodo pubblicoGetReadStream(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 pubblicoGetReadStream(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 pubblicoGetReadStream(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 pubblicoGetReadStreamUri(Object)Ottiene l'URI utilizzato per restituire un flusso di dati binari.
Metodo pubblicoGetReadStreamUri(Object, String)Ottiene l'URI utilizzato per restituire un flusso di dati binari denominato.
Metodo pubblicoGetType Ereditato da Object.
Metodo pubblicoLoadProperty(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 pubblicoLoadProperty(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 pubblicoLoadProperty(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 pubblicoLoadProperty<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 protettoMemberwiseClone Ereditato da Object.
Metodo pubblicoSaveChanges()Salva le modifiche rilevate da DataServiceContext per l'archiviazione.Non supportato dal client di WCF Data Services 5.0 per Silverlight.
Metodo pubblicoSaveChanges(SaveChangesOptions)Salva le modifiche rilevate da DataServiceContext per l'archiviazione.Non supportato dal client di WCF Data Services 5.0 per Silverlight.
Metodo pubblicoSetLinkNotifica 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 pubblicoSetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)Imposta un flusso di dati binari per l'entità specificata con le intestazioni specificate nel messaggio di richiesta.
Metodo pubblicoSetSaveStream(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 pubblicoSetSaveStream(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 pubblicoSetSaveStream(Object, String, Stream, Boolean, String)Imposta un flusso di dati binari per l'entità specificata.
Metodo pubblicoToString Ereditato da Object.
Metodo pubblicoTryGetEntity<TEntity>Recupero di prova di un'entità rilevata da DataServiceContext per riferimento all'URI dell'entità.
Metodo pubblicoTryGetUriRecupera l'URI canonico associato all'entità specificata, se disponibile.
Metodo pubblicoUpdateObjectModifica in Modified lo stato dell'oggetto specificato in DataServiceContext.
In alto

  NomeDescrizione
Evento pubblicoReadingEntitySi verifica dopo che i dati dell'entità sono stati completamente letti nell'oggetto entità.
Evento pubblicoSendingRequestSi verifica in caso di creazione di un nuovo oggetto HttpWebRequest.
Evento pubblicoSendingRequest2Si verifica in caso di creazione di un nuovo oggetto HttpWebRequest.
Evento pubblicoWritingEntitySi verifica dopo che un'entità è stata completamente serializzata in XML in un messaggio di richiesta.
In alto

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.

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


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

Aggiunte alla community

Mostra:
© 2016 Microsoft