DataServiceContext Classe

Definizione

Spazio dei nomi:
System.Data.Services.Client
Assembly:
System.Data.Services.Client.dll

Rappresenta DataServiceContext il contesto di runtime del servizio dati.

public ref class DataServiceContext
public class DataServiceContext
type DataServiceContext = class
Public Class DataServiceContext
Ereditarietà
Object
DataServiceContext

Esempio

Nell'esempio seguente viene illustrato come usare l'oggetto DataServiceContext generato dallo strumento Add Service Reference per eseguire in modo implicito una query sul servizio dati Northwind che restituisce tutti i clienti. L'URI del set di entità richiesto Customers viene determinato automaticamente dal contesto. La query viene eseguita in modo implicito quando si verifica l'enumerazione . Il servizio dati Northwind viene creato al termine 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);
}

' 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

Commenti

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

Costruttori

Nome Descrizione
DataServiceContext(Uri)

Inizializza una nuova istanza della DataServiceContext classe con l'oggetto specificato serviceRoot.

Proprietà

Nome Descrizione
ApplyingChanges

Ottiene un valore che indica se l'oggetto DataServiceContext sta applicando modifiche agli oggetti rilevati.
BaseUri

Ottiene l'URI assoluto che identifica la radice del servizio dati di destinazione.
Credentials

Ottiene o imposta le informazioni di autenticazione utilizzate da ogni query creata tramite l'oggetto DataServiceContext .
DataNamespace

Ottiene o imposta lo spazio dei nomi XML per gli elementi di dati, non gli elementi di metadati, di un payload Atom.
Entities

Ottiene un elenco di tutte le risorse attualmente rilevate dall'oggetto DataServiceContext.
IgnoreMissingProperties

Ottiene o imposta un valore che indica se le proprietà lette dal tipo devono essere mappate alle proprietà sul tipo lato client.
IgnoreResourceNotFoundException

Ottiene o imposta un valore che indica se viene generata un'eccezione quando viene restituito un errore 404 (risorsa non trovata) dal servizio dati.
Links

Ottiene l'insieme di tutte le associazioni o i collegamenti attualmente rilevati dall'oggetto DataServiceContext .
MergeOption

Ottiene o imposta l'opzione di sincronizzazione per la ricezione di entità da un servizio dati.
ResolveName

Ottiene o imposta una funzione per eseguire l'override della strategia di risoluzione dei tipi predefinita utilizzata dalla libreria client quando si inviano entità a un servizio dati.
ResolveType

Ottiene o imposta una funzione utilizzata per eseguire l'override dell'opzione di risoluzione dei tipi predefinita utilizzata dalla libreria client durante la ricezione di entità da un servizio dati.
SaveChangesDefaultOptions

Ottiene o imposta i SaveChangesOptions valori utilizzati dal SaveChanges() metodo .
Timeout

Ottiene o imposta l'opzione di timeout utilizzata per la richiesta HTTP sottostante al servizio dati.
TypeScheme

Ottiene o imposta l'URI utilizzato per indicare lo schema di tipo utilizzato dal servizio.
UsePostTunneling

Ottiene o imposta un valore booleano che indica se utilizzare post tunneling.

Metodi

Nome Descrizione
AddLink(Object, String, Object)

Aggiunge il collegamento specificato al set di oggetti di cui viene eseguito il DataServiceContext rilevamento.
AddObject(String, Object)

Aggiunge l'oggetto specificato al set di oggetti di cui esegue il DataServiceContext rilevamento.
AddRelatedObject(Object, String, Object)

Aggiunge un oggetto correlato al contesto e crea il collegamento che definisce la relazione tra i due oggetti in una singola richiesta.
AttachLink(Object, String, Object)

Notifica all'oggetto DataServiceContext di avviare il rilevamento del collegamento specificato che definisce una relazione tra oggetti entità.
AttachTo(String, Object, String)

Notifica all'oggetto DataServiceContext di avviare il rilevamento della risorsa specificata e fornisce la posizione della risorsa nel set di risorse specificato.
AttachTo(String, Object)

Notifica all'oggetto DataServiceContext di avviare il rilevamento della risorsa specificata e fornisce la posizione della risorsa all'interno del set di risorse specificato.
BeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)

Invia in modo asincrono una richiesta al servizio dati per recuperare la pagina successiva dei dati in un risultato della query con paging.
BeginExecute<TElement>(Uri, AsyncCallback, Object)

Invia in modo asincrono la richiesta in modo che questa chiamata non blocchi l'elaborazione durante l'attesa dei risultati dal servizio.
BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[])

Invia in modo asincrono un gruppo di query come batch al servizio dati.
BeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object)

Ottiene in modo asincrono i dati delle proprietà binarie per l'entità specificata come flusso di dati insieme alle intestazioni del messaggio specificate.
BeginLoadProperty(Object, String, AsyncCallback, Object)

Carica in modo asincrono il valore della proprietà specificata dal servizio dati.
BeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object)

Carica in modo asincrono la pagina successiva di entità correlate dal servizio dati usando l'oggetto di continuazione query fornito.
BeginLoadProperty(Object, String, Uri, AsyncCallback, Object)

Carica in modo asincrono una pagina di entità correlate dal servizio dati usando l'URI di collegamento successivo fornito.
BeginSaveChanges(AsyncCallback, Object)

Invia in modo asincrono le modifiche in sospeso al servizio dati raccolto dall'ultima DataServiceContext volta che sono state salvate le modifiche.
BeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)

Invia in modo asincrono le modifiche in sospeso al servizio dati raccolto dall'ultima DataServiceContext volta che sono state salvate le modifiche.
CancelRequest(IAsyncResult)

Tenta di annullare l'operazione associata all'oggetto fornito IAsyncResult .
CreateQuery<T>(String)

Crea una query del servizio dati per i dati di un tipo generico specificato.
DeleteLink(Object, String, Object)

Modifica lo stato del collegamento da eliminare nell'elenco dei collegamenti rilevati da DataServiceContext.
DeleteObject(Object)

Modifica lo stato dell'oggetto specificato da eliminare in DataServiceContext.
Detach(Object)

Rimuove l'entità dall'elenco di entità di rilevamento DataServiceContext .
DetachLink(Object, String, Object)

Rimuove il collegamento specificato dall'elenco dei collegamenti rilevati da DataServiceContext.
EndExecute<TElement>(IAsyncResult)

Chiamato per completare l'oggetto BeginExecute<TElement>(Uri, AsyncCallback, Object).
EndExecuteBatch(IAsyncResult)

Chiamato per completare l'oggetto BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[]).
EndGetReadStream(IAsyncResult)

Chiamato per completare l'operazione asincrona di recupero di una proprietà binaria come flusso.
EndLoadProperty(IAsyncResult)

Chiamato per completare l'operazione BeginLoadProperty(Object, String, AsyncCallback, Object) .
EndSaveChanges(IAsyncResult)

Chiamato per completare l'operazione BeginSaveChanges(AsyncCallback, Object) .
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
Execute<T>(DataServiceQueryContinuation<T>)

Invia una richiesta al servizio dati per recuperare la pagina successiva dei dati in un risultato della query di paging.
Execute<TElement>(Uri)

Invia una richiesta al servizio dati per eseguire un URI specifico.
ExecuteBatch(DataServiceRequest[])

Invia un gruppo di query come batch al servizio dati.
GetEntityDescriptor(Object)

Ottiene l'oggetto EntityDescriptor per l'oggetto entità fornito.
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetLinkDescriptor(Object, String, Object)

Ottiene l'oggetto LinkDescriptor per un collegamento specifico che definisce la relazione tra due entità.
GetMetadataUri()

Ottiene un URI della posizione dei metadati .edmx.
GetReadStream(Object, DataServiceRequestArgs)

Ottiene i dati della proprietà binaria per l'entità specificata come flusso di dati insieme alle intestazioni del messaggio specificate.
GetReadStream(Object, String)

Ottiene i dati della proprietà binaria per l'entità specificata come flusso di dati, con l'intestazione accept del messaggio specificata.
GetReadStream(Object)

Ottiene i dati della proprietà binaria per l'entità specificata come flusso di dati.
GetReadStreamUri(Object)

Ottiene l'URI utilizzato per restituire dati di proprietà binaria come flusso di dati.
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
LoadProperty(Object, String, DataServiceQueryContinuation)

Carica la pagina successiva di entità correlate dal servizio dati usando l'oggetto di continuazione query fornito.
LoadProperty(Object, String, Uri)

Carica una pagina di entità correlate usando l'URI di collegamento successivo fornito.
LoadProperty(Object, String)

Carica il contenuto posticipato per una proprietà specificata dal servizio dati.
LoadProperty<T>(Object, String, DataServiceQueryContinuation<T>)

Carica la pagina successiva delle entità correlate dal servizio dati usando l'oggetto di continuazione query generico fornito.
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
SaveChanges()

Salva le modifiche che l'oggetto sta monitorando nell'archiviazione DataServiceContext .
SaveChanges(SaveChangesOptions)

Salva le modifiche che l'oggetto sta monitorando nell'archiviazione DataServiceContext .
SetLink(Object, String, Object)

Notifica all'oggetto DataServiceContext che esiste un nuovo collegamento tra gli oggetti specificati e che il collegamento è rappresentato dalla proprietà specificata dal sourceProperty parametro .
SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)

Imposta un nuovo flusso di dati come proprietà binaria di un'entità, con le impostazioni specificate nel messaggio di richiesta.
SetSaveStream(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.
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
TryGetEntity<TEntity>(Uri, TEntity)

Testare il recupero di un'entità rilevata dal per DataServiceContext riferimento all'URI dell'entità.
TryGetUri(Object, Uri)

Recupera l'URI canonico associato all'entità specificata, se disponibile.
UpdateObject(Object)

Modifica lo stato dell'oggetto specificato in DataServiceContext in Modified.

Eventi

Nome Descrizione
ReadingEntity

Si verifica dopo che i dati dell'entità sono stati letti completamente nell'oggetto entità.
SendingRequest

Si verifica quando è stato creato un nuovo HttpWebRequest oggetto .
WritingEntity

Si verifica dopo che un'entità è stata completamente serializzata in XML in un messaggio di richiesta.

Si applica a

Vedi anche