DataServiceContext Klasse

Definition

Namespace:

System.Data.Services.Client

Assembly:

System.Data.Services.Client.dll

Der DataServiceContext stellt den Laufzeitkontext des Datendiensts dar.

public ref class DataServiceContext

public class DataServiceContext

type DataServiceContext = class

Public Class DataServiceContext

Vererbung

Object

DataServiceContext

Beispiele

Das folgende Beispiel zeigt die Verwendung von DataServiceContext, erzeugt durch das Tool zum Hinzufügen einer Dienstreferenz, für die explizite Ausführung einer Abfrage an den Northwind-Datendienst, die alle Kunden zurückgibt. Der URI der angeforderten Customers-Entitätenmenge wird automatisch vom Kontext bestimmt. Die Abfrage wird implizit ausgeführt, wenn die Enumeration auftritt. Der Northwind-Datendienst wird erstellt, wenn Sie die WCF Data Services abschließen.

// 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

Hinweise

WCF Data Services zustandslos sind, aber das DataServiceContext ist nicht. Der Client-Status bleibt zwischen Interaktionen erhalten, um Funktionen (z. B. die Updateverwaltung) zu unterstützen. Diese Klasse und die Klasse DataServiceQuery, die eine bestimmte HTTP-Anforderung an einen Datendienst darstellt, sind die beiden Hauptklassen in der Clientbibliothek.

Konstruktoren

DataServiceContext(Uri)

Initialisiert eine neue Instanz der DataServiceContext-Klasse mit der angegebenen serviceRoot.

Eigenschaften

ApplyingChanges	Ruft einen Wert ab, der angibt, ob DataServiceContext Änderungen für nachverfolgte Objekte übernimmt.
BaseUri	Ruft den absoluten URI ab, der den Stamm des Zieldatendiensts identifiziert.
Credentials	Ruft die Authentifizierungsinformationen ab, die von jeder mit dem DataServiceContext-Objekt erstellten Abfrage verwendet werden, oder legt sie fest.
DataNamespace	Ruft den XML-Namespace für Datenelemente (nicht Metadatenelemente) eines Atom-Stoms ab oder legt ihn fest.
Entities	Ruft eine Liste aller Ressourcen ab, die gerade von DataServiceContext nachverfolgt wird.
IgnoreMissingProperties	Abrufen/Definieren, ob vom Typ gelesene Eigenschaften dem clientseitigen Typ zugeordnet werden müssen.
IgnoreResourceNotFoundException	Abrufen/Definieren, ob eine Ausnahme ausgelöst wird, wenn ein Fehler mit dem Fehlercode 404 (Die Ressource wurde nicht gefunden) vom Datendienst zurückgegeben wird.
Links	Ruft die Auflistung aller Zuordnungen oder Links ab, die gerade durch das DataServiceContext-Objekt verfolgt werden.
MergeOption	Ruft die Synchronisierungsoption zum Empfangen von Entitäten von einem Datendienst ab oder legt sie fest.
ResolveName	Abrufen/Definieren einer Funktion zum Außerkraftsetzen der Standardtypauflösungsstrategie, die von der Client-Bibliothek beim Senden von Entitäten an einen Datendienst verwendet wurde.
ResolveType	Abrufen/Definieren einer Funktion, die beim Empfangen von Entitäten von einem Datendienst zum Außerkraftsetzen einer Funktion verwendet wird.
SaveChangesDefaultOptions	Abrufen/Definieren der SaveChangesOptions-Werte, die von der Methode SaveChanges() verwendet werden.
Timeout	Übernimmt oder bestimmt die Timeoutoption für die zugrunde liegende HTTP-Anforderung an den Datendienst.
TypeScheme	Abrufen/Definieren des URI ab, der verwendet wurde, um das Typschema des Diensts anzugeben.
UsePostTunneling	Ruft einen booleschen Wert ab, der angibt, ob Nachtunneln verwendet wird.

Methoden

AddLink(Object, String, Object)	Fügt den angegebenen Link dem Satz von Objekten hinzu, den der DataServiceContext nachverfolgt.
AddObject(String, Object)	Fügt das angegebene Objekt dem Satz von Objekten hinzu, den der DataServiceContext nachverfolgt.
AddRelatedObject(Object, String, Object)	Fügt dem Kontext ein verknüpftes Objekt hinzu und erstellt den Link, der die Beziehung zwischen den zwei Objekten in einer einzelnen Anforderung definiert.
AttachLink(Object, String, Object)	Benachrichtigt DataServiceContext, mit der Verfolgung des Links zu beginnen, der eine Beziehung zwischen Entitätsobjekten definiert.
AttachTo(String, Object)	Benachrichtigt den DataServiceContext, mit der Verfolgung der angegebenen Ressource zu beginnen und gibt die Position der Ressource zum angegebenen Ressourcensatz an.
AttachTo(String, Object, String)	Benachrichtigt den DataServiceContext, mit der Verfolgung der angegebenen Ressource zu beginnen und gibt die Position der Ressource zum angegebenen Ressourcensatz an.
BeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)	Sendet asynchron eine Anforderung an den Datendienst, um die nächste Seite der Daten in einem ausgelagerten Abfrageergebnis abzurufen.
BeginExecute<TElement>(Uri, AsyncCallback, Object)	Asynchron sendet die Anforderung, damit dieser Aufruf beim Warten auf die Ergebnisse vom Dienst keine Verarbeitung blockiert.
BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[])	Sendet asynchron eine Gruppe von Abfragen als Batch an den Datendienst.
BeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object)	Ruft asynchron binäre Eigenschaftendaten für die angegebene Entität zusammen mit den angegebenen Nachrichtenheadern als Datenstrom ab.
BeginLoadProperty(Object, String, AsyncCallback, Object)	Lädt den Wert der angegebenen Eigenschaft vom Datendienst asynchron.
BeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object)	Lädt asynchron die nächste Seite der verknüpften Entitäten vom Datendienst mit dem angegebenen Abfragefortsetzungsobjekt.
BeginLoadProperty(Object, String, Uri, AsyncCallback, Object)	Lädt asynchron mit dem angegebenen nächsten Link-URI eine Seite der verknüpften Entitäten vom Datendienst.
BeginSaveChanges(AsyncCallback, Object)	Übergibt die anstehenden Änderungen asynchron an den von DataServiceContext gesammelten Datendienst seit der letzten Speicherung von Änderungen.
BeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)	Übergibt die anstehenden Änderungen asynchron an den von DataServiceContext gesammelten Datendienst seit der letzten Speicherung von Änderungen.
CancelRequest(IAsyncResult)	Versucht, den Vorgang abzubrechen, der dem angegebenen IAsyncResult-Objekt zugeordnet ist.
CreateQuery<T>(String)	Erstellt eine Datendienstabfrage für Daten eines angegebenen generischen Typs.
DeleteLink(Object, String, Object)	Ändert den Zustand des Links in der Liste, die von DataServiceContext nachverfolgt wird, in Deleted.
DeleteObject(Object)	Ändert den Zustand des angegebenen Objekts, das in DataServiceContext gelöscht werden soll.
Detach(Object)	Entfernt die Entität aus der Liste der Entitäten, die DataServiceContext nachverfolgt.
DetachLink(Object, String, Object)	Entfernt den angegebenen Link aus der Liste der Links, die von DataServiceContext nachverfolgt wird.
EndExecute<TElement>(IAsyncResult)	Wird aufgerufen, um BeginExecute<TElement>(Uri, AsyncCallback, Object) abzuschließen.
EndExecuteBatch(IAsyncResult)	Wird aufgerufen, um BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[]) abzuschließen.
EndGetReadStream(IAsyncResult)	Wird aufgerufen, um den asynchronen Vorgang des Abrufs einer binären Eigenschaft als Datenstrom abzuschließen.
EndLoadProperty(IAsyncResult)	Wird aufgerufen, um den BeginLoadProperty(Object, String, AsyncCallback, Object)-Vorgang abzuschließen.
EndSaveChanges(IAsyncResult)	Wird aufgerufen, um den BeginSaveChanges(AsyncCallback, Object)-Vorgang abzuschließen.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
Execute<T>(DataServiceQueryContinuation<T>)	Sendet eine Anforderung an den Datendienst, um die nächste Seite der Daten in einem ausgelagerten Abfrageergebnis abzurufen.
Execute<TElement>(Uri)	Sendet eine Anforderung an den Datendienst, um einen bestimmten URI auszuführen.
ExecuteBatch(DataServiceRequest[])	Sendet eine Gruppe von Abfragen als Batch an den Datendienst.
GetEntityDescriptor(Object)	Ruft den EntityDescriptor für das angegebene Entitätsobjekt ab.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLinkDescriptor(Object, String, Object)	Ruft LinkDescriptor für einen bestimmten Link ab, der die Beziehung zwischen zwei Entitäten definiert.
GetMetadataUri()	Ruft einen URI des Speicherorts der .edmx-Metadaten ab.
GetReadStream(Object)	Ruft binäre Eigenschaftendaten für die angegebene Entität als Datenstrom ab.
GetReadStream(Object, DataServiceRequestArgs)	Ruft binäre Eigenschaftendaten für die angegebene Entität zusammen mit den angegebenen Nachrichtenheadern als Datenstrom ab.
GetReadStream(Object, String)	Ruft binäre Eigenschaftendaten für die angegebene Entität zusammen mit dem angegebenen Accept-Nachrichtenheader als Datenstrom ab.
GetReadStreamUri(Object)	Ruft den URI ab, der verwendet wird, um binäre Eigenschaftendaten als Datenstrom zurückzugeben.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
LoadProperty(Object, String)	Lädt verzögerte Inhalte für eine angegebene Eigenschaft vom Datendienst.
LoadProperty(Object, String, DataServiceQueryContinuation)	Lädt die nächste Seite der verknüpften Entitäten vom Datendienst mit dem angegebenen Abfragefortsetzungsobjekt.
LoadProperty(Object, String, Uri)	Lädt mit dem angegebenen nächsten Link-URI eine Seite von verknüpften Entitäten.
LoadProperty<T>(Object, String, DataServiceQueryContinuation<T>)	Lädt die nächste Seite der verknüpften Entitäten vom Datendienst mit dem angegebenen generischen Abfragefortsetzungsobjekt.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
SaveChanges()	Speichert die Änderungen, die DataServiceContext zur Speicherung nachverfolgt.
SaveChanges(SaveChangesOptions)	Speichert die Änderungen, die DataServiceContext zur Speicherung nachverfolgt.
SetLink(Object, String, Object)	Benachrichtigt DataServiceContext, dass ein neuer Link zwischen den Objekten vorhanden ist und dass der Link von der durch den sourceProperty-Parameter angegebenen Eigenschaft dargestellt wird.
SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)	Legt einen neuen Datenstrom mit den angegebenen Einstellungen in der Anforderungsnachricht als die binäre Eigenschaft einer Entität fest.
SetSaveStream(Object, Stream, Boolean, String, String)	Legt einen neuen Datenstrom als binäre Eigenschaft einer Entität fest. Die angegebenen Content-Type- und Slug-Header sind in der Anforderungsnachricht enthalten.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
TryGetEntity<TEntity>(Uri, TEntity)	Testabruf einer Entität, die von DataServiceContext durch Verweis auf den URI der Entität nachverfolgt wird.
TryGetUri(Object, Uri)	Ruft den kanonischen URI der angegebenen Entität ab (falls verfügbar).
UpdateObject(Object)	Ändert den Zustand des angegebenen Objekts in DataServiceContext im Modified.

Ereignisse

ReadingEntity	Tritt auf, nachdem Entitätsdaten vollständig in das Entitätsobjekt geladen wurden.
SendingRequest	Tritt auf, wenn HttpWebRequest neu erstellt wurde.
WritingEntity	Tritt auf, nachdem eine Entität in einer Anforderungsnachricht vollständig in XML serialisiert wurde.

Weitere Informationen

• Arbeiten mit .NET Framework Clientbibliotheken (WCF Data Services)