Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale

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:  System.Data.Services.Client (in System.Data.Services.Client.dll)

public class DataServiceContext

Il tipo DataServiceContext espone i seguenti membri.

  NomeDescrizione
Metodo pubblicoDataServiceContextInizializza una nuova istanza della classe DataServiceContext con l'oggetto serviceRoot specificato.
In alto

  NomeDescrizione
Proprietà pubblicaApplyingChangesOttiene un valore che indica se DataServiceContext applica le 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 ciascuna query creata mediante l'oggetto DataServiceContext.
Proprietà pubblicaDataNamespaceOttiene o imposta lo spazio dei nomi XML per gli elementi di dati, non di metadati, di un payload Atom.
Proprietà pubblicaEntitiesOttiene un elenco di tutte le risorse attualmente rilevate da DataServiceContext.
Proprietà pubblicaIgnoreMissingPropertiesOttiene o imposta un valore che indica se è necessario eseguire il mapping delle proprietà lette dal tipo alle proprietà nel tipo sul lato client.
Proprietà pubblicaIgnoreResourceNotFoundExceptionOttiene o imposta se viene generata un'eccezione quando viene restituito un errore 404 (Impossibile trovare la risorsa) dal servizio dati.
Proprietà pubblicaLinksOttiene la raccolta di tutte le associazioni o i collegamenti attualmente rilevati dall'oggetto DataServiceContext.
Proprietà pubblicaMergeOptionOttiene o imposta l'opzione di sincronizzazione per la ricezione di entità da un servizio dati.
Proprietà pubblicaResolveNameOttiene o imposta una funzione che consente di eseguire l'override della strategia di risoluzione dei tipi predefinita utilizzata dalla libreria client durante l'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 durante la 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 utilizzata per la richiesta HTTP sottostante al servizio dati.
Proprietà pubblicaTypeSchemeOttiene o imposta l'URI che serve a indicare lo schema del tipo utilizzato dal servizio.
Proprietà pubblicaUsePostTunnelingOttiene o imposta un valore booleano che indica se utilizzare il tunneling di invio.
In alto

  NomeDescrizione
Metodo pubblicoAddLinkAggiunge il collegamento specificato all'insieme di oggetti rilevati da DataServiceContext.
Metodo pubblicoAddObjectAggiunge l'oggetto specificato all'insieme di oggetti rilevati 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 avviare il rilevamento del collegamento specificato che definisce una relazione tra oggetti entità.
Metodo pubblicoAttachTo(String, Object)Notifica a DataServiceContext l'avvio del rilevamento della risorsa specificata e fornisce la posizione della risorsa all'interno dell'insieme di risorse specificato.
Metodo pubblicoAttachTo(String, Object, String)Notifica a DataServiceContext di avviare il rilevamento della risorsa specificata e fornisce la posizione della risorsa nel set di risorse specificato.
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 della query di paging.
Metodo pubblicoBeginExecute<TElement>(Uri, AsyncCallback, Object)Invia la richiesta in modo asincrono, in modo tale che questa chiamata non blocchi l'elaborazione nell'attesa dei risultati inviati dal servizio.
Metodo pubblicoBeginExecuteBatchInvia al servizio dati un gruppo di query sotto forma di batch in modo asincrono.
Metodo pubblicoBeginGetReadStreamOttiene in modo asincrono i dati della proprietà binaria per l'entità specificata come flusso di dati insieme alle 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 di entità correlate successiva dal servizio dati tramite l'oggetto di continuazione della 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 relativa ai dati di un tipo generico specificato.
Metodo pubblicoDeleteLinkModifica lo stato del collegamento in Deleted nell'elenco dei collegamenti rilevati da DataServiceContext.
Metodo pubblicoDeleteObjectModifica lo stato dell'oggetto specificato che deve essere eliminato in DataServiceContext.
Metodo pubblicoDetachRimuove l'entità dall'elenco di entità rilevate da DataServiceContext.
Metodo pubblicoDetachLinkRimuove il collegamento specificato dall'elenco dei collegamenti rilevati da DataServiceContext.
Metodo pubblicoEndExecute<TElement>Chiamato per completare BeginExecute.
Metodo pubblicoEndExecuteBatchChiamato per completare BeginExecuteBatch.
Metodo pubblicoEndGetReadStreamChiamato per completare l'operazione asincrona di recupero di una proprietà binaria come un flusso.
Metodo pubblicoEndLoadPropertyChiamato per completare l'operazione BeginLoadProperty.
Metodo pubblicoEndSaveChangesChiamato per completare l'operazione BeginSaveChanges.
Metodo pubblicoEquals(Object) Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Metodo pubblicoExecute<T>(DataServiceQueryContinuation<T>)Invia una richiesta al servizio dati per recuperare la pagina di dati successiva in un risultato della query di paging.
Metodo pubblicoExecute<TElement>(Uri)Invia una richiesta al servizio dati per eseguire un URI specifico.
Metodo pubblicoExecuteBatchInvia al servizio dati un gruppo di query sotto forma di batch.
Metodo protettoFinalize Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga reclamato dalla procedura di Garbage Collection. (Ereditato da Object)
Metodo pubblicoGetEntityDescriptorOttiene l'oggetto EntityDescriptor per l'oggetto entità fornito.
Metodo pubblicoGetHashCode Funge da funzione hash per un particolare tipo. (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 EDMX.
Metodo pubblicoGetReadStream(Object)Ottiene i dati della proprietà binaria per l'entità specificata come flusso di dati.
Metodo pubblicoGetReadStream(Object, DataServiceRequestArgs)Ottiene i dati della proprietà binaria per l'entità specificata come flusso di dati insieme alle intestazioni di messaggio specificate.
Metodo pubblicoGetReadStream(Object, String)Ottiene i dati della proprietà binaria per l'entità specificata come flusso di dati, con l'intestazione del messaggio Accept specificato.
Metodo pubblicoGetReadStreamUriOttiene l'URI utilizzato per restituire dati della proprietà binaria come flusso di dati.
Metodo pubblicoGetType Ottiene il Type dell'istanza corrente. (Ereditato da Object)
Metodo pubblicoLoadProperty(Object, String)Carica il contenuto posticipato per una proprietà specificata dal servizio dati.
Metodo pubblicoLoadProperty(Object, String, DataServiceQueryContinuation)Carica la pagina di entità correlate successiva dal servizio dati tramite l'oggetto di continuazione della query fornito.
Metodo pubblicoLoadProperty(Object, String, Uri)Carica una pagina di entità correlate tramite l'URI del collegamento successivo fornito.
Metodo pubblicoLoadProperty<T>(Object, String, DataServiceQueryContinuation<T>)Carica la pagina di entità correlate successiva dal servizio dati tramite l'oggetto di continuazione della query generico fornito.
Metodo protettoMemberwiseClone Crea una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
Metodo pubblicoSaveChanges()Salva le modifiche rilevate da DataServiceContext nell'archivio.
Metodo pubblicoSaveChanges(SaveChangesOptions)Salva le modifiche rilevate da DataServiceContext nell'archivio.
Metodo pubblicoSetLinkNotifica a DataServiceContext la presenza di un nuovo collegamento tra gli oggetti specificati, precisando che tale collegamento è rappresentato dalla proprietà specificata dal parametro sourceProperty.
Metodo pubblicoSetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)Imposta un nuovo flusso di dati come proprietà binaria di un'entità, con le impostazioni specificate nel messaggio di richiesta.
Metodo pubblicoSetSaveStream(Object, Stream, Boolean, String, String)Imposta un nuovo flusso di dati come proprietà binaria di un'entità. Le intestazioni Content-Type e Slug specificate sono incluse nel messaggio di richiesta.
Metodo pubblicoToString Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Metodo pubblicoTryGetEntity<TEntity>Recupero di prova di un'entità rilevata da DataServiceContext mediante riferimento all'URI dell'entità.
Metodo pubblicoTryGetUriRecupera l'URI canonico associato all'entità specificata, se disponibile.
Metodo pubblicoUpdateObjectModifica lo stato dell'oggetto specificato in DataServiceContext in Modified.
In alto

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

WCF Data Services non contiene informazioni sullo stato, ma DataServiceContext le contiene. Al fine di supportare funzionalità quali la gestione degli aggiornamenti, lo stato sul client viene gestito tra le varie interazioni. Questa e la classe DataServiceQuery, che rappresenta una particolare richiesta HTTP a un servizio dati, sono le due classi principali nella libreria client.

Nell'esempio riportato di seguito viene illustrato come utilizzare DataServiceContext generato dallo strumento Aggiungi riferimento a 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 è determinato automaticamente dal contesto. La query viene eseguita in modo esplicito quando si verifica l'enumerazione. Il servizio dati Northwind viene creato quando si completa la WCF Data Services guida rapida.


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


.NET Framework

Supportato in: 4.5.2, 4.5.1, 4.5, 4, 3.5 SP1

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft