Freigeben über

DataServiceContext-Klasse

  • Artikel

Der DataServiceContext stellt den Laufzeitkontext des Datendiensts dar.

Vererbungshierarchie

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

Namespace:  System.Data.Services.Client
Assembly:  Microsoft.Data.Services.Client (in Microsoft.Data.Services.Client.dll)

Syntax

'Declaration
Public Class DataServiceContext
'Usage
Dim instance As DataServiceContext

public class DataServiceContext

public ref class DataServiceContext

type DataServiceContext =  class end

public class DataServiceContext

Der DataServiceContext-Typ macht folgende Elemente verfügbar.

Konstruktoren

  Name Beschreibung
Öffentliche Methode DataServiceContext() Initialisiert eine neue Instanz der DataServiceContext-Klasse.
Öffentliche Methode DataServiceContext(Uri) Initialisiert eine neue Instanz der DataServiceContext-Klasse mit dem angegebenen serviceRoot.
Öffentliche Methode DataServiceContext(Uri, DataServiceProtocolVersion) Initialisiert eine neue Instanz der Klasse DataServiceContext mit dem angegebenen serviceRoot und für die betreffende maxProtocolVersion.

Zum Anfang

Eigenschaften

  Name Beschreibung
Öffentliche Eigenschaft AddAndUpdateResponsePreference Ruft ab oder legt fest, ob der Client die Datendienstrückgabe-Entitätsdaten in der Antwortnachricht zu einer Änderungsanforderung anfordert.
Öffentliche Eigenschaft ApplyingChanges Ruft einen Wert ab, der angibt, ob DataServiceContext Änderungen für nachverfolgte Objekte übernimmt.
Öffentliche Eigenschaft BaseUri Ruft den absoluten URI ab, der den Stamm des Zieldatendiensts identifiziert.
Öffentliche Eigenschaft Credentials Ruft die Authentifizierungsinformationen ab, die von jeder mit dem DataServiceContext-Objekt erstellten Abfrage verwendet werden, oder legt sie fest.
Öffentliche Eigenschaft DataNamespace Ruft den XML-Namespace für Datenelemente (nicht Metadatenelemente) eines Atom-Stoms ab oder legt ihn fest.
Öffentliche Eigenschaft Entities Ruft eine Liste aller Ressourcen ab, die gerade von DataServiceContext nachverfolgt wird.
Öffentliche Eigenschaft HttpStack Ruft einen booleschen Wert ab, der den Typ der HTTP-Implementierung für den Zugriff auf den Datendienst angibt.Wird nur vom WCF Data Services 5.0-Client für Silverlight unterstützt.
Öffentliche Eigenschaft IgnoreMissingProperties Abrufen/Definieren, ob vom Typ gelesene Eigenschaften dem clientseitigen Typ zugeordnet werden müssen.
Öffentliche Eigenschaft 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.
Öffentliche Eigenschaft Links Ruft die Auflistung aller Zuordnungen oder Links ab, die gerade durch das DataServiceContext-Objekt verfolgt werden.
Öffentliche Eigenschaft MaxProtocolVersion Ermittelt die maximale Version vom Open Data Protocol (OData) , die der Client nutzen darf.
Öffentliche Eigenschaft MergeOption Ruft die Synchronisierungsoption zum Empfangen von Entitäten von einem Datendienst ab oder legt sie fest.
Öffentliche Eigenschaft ResolveEntitySet Abrufen/Definieren der Delegiertenmethode, die verwendet wird, um den Entitätenmengen-URI aufzulösen, wenn der Wert nicht von einem Bearbeitungslink oder einem Selbst-Link-URI bestimmt werden kann..
Öffentliche Eigenschaft 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.
Öffentliche Eigenschaft ResolveType Abrufen/Definieren einer Funktion, die beim Empfangen von Entitäten von einem Datendienst zum Außerkraftsetzen einer Funktion verwendet wird.
Öffentliche Eigenschaft SaveChangesDefaultOptions Abrufen/Definieren der SaveChangesOptions-Werte, die von der Methode SaveChanges verwendet werden.
Öffentliche Eigenschaft Timeout Abrufen/Definieren der Zeitüberschreitungsoption (in Sekunden) für die zu Grunde liegende HTTP-Anforderung an den Datendienst.
Öffentliche Eigenschaft TypeScheme Abrufen/Definieren des URI ab, der verwendet wurde, um das Typschema des Diensts anzugeben.
Öffentliche Eigenschaft UseDefaultCredentials Ermittelt/definiert, ob Anforderungen an den Datendienst mithilfe von Standardanmeldeinformationen authentifiziert werden sollen. Wird nur vom WCF Data Services 5.0-Client für Silverlight unterstützt.
Öffentliche Eigenschaft UsePostTunneling Ruft einen booleschen Wert ab, der angibt, ob Nachtunneln verwendet wird.

Zum Anfang

Methoden

  Name Beschreibung
Öffentliche Methode AddLink Fügt den angegebenen Link dem Satz von Objekten hinzu, den der DataServiceContext nachverfolgt.
Öffentliche Methode AddObject Fügt das angegebene Objekt dem Satz von Objekten hinzu, den der DataServiceContext nachverfolgt.
Öffentliche Methode AddRelatedObject 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.
Öffentliche Methode AttachLink Benachrichtigt DataServiceContext, mit der Verfolgung des Links zu beginnen, der eine Beziehung zwischen Entitätsobjekten definiert.
Öffentliche Methode AttachTo(String, Object) Benachrichtigt den DataServiceContext, mit der Verfolgung der angegebenen Ressource zu beginnen und gibt die Position der Ressource zum angegebenen Ressourcensatz an.
Öffentliche Methode 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.
Öffentliche Methode BeginExecute(Uri, AsyncCallback, Object, String, array<OperationParameter[]) Sendet asynchron eine Anforderung an den Datendienst, um einen bestimmten URI auszuführen.
Öffentliche Methode BeginExecute<TElement>(Uri, AsyncCallback, Object) Asynchron sendet die Anforderung, damit dieser Aufruf beim Warten auf die Ergebnisse vom Dienst keine Verarbeitung blockiert.
Öffentliche Methode 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.
Öffentliche Methode BeginExecute<TElement>(Uri, AsyncCallback, Object, String, Boolean, array<OperationParameter[]) Sendet asynchron eine Anforderung an den Datendienst, um einen bestimmten URI auszuführen.
Öffentliche Methode BeginExecuteBatch Sendet asynchron eine Gruppe von Abfragen als Batch an den Datendienst.
Öffentliche Methode BeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object) Ruft asynchron den binären Datenstrom ab, der zur angegebenen Entität gehört (mit dem angegebenen Content-Type-Nachrichtenheader).
Öffentliche Methode BeginGetReadStream(Object, String, DataServiceRequestArgs, AsyncCallback, Object) Ruft asynchron einen benannten binären Datenstrom ab, der zur angegebenen Entität gehört (mit dem angegebenen Content-Type-Nachrichtenheader).
Öffentliche Methode BeginLoadProperty(Object, String, AsyncCallback, Object) Lädt den Wert der angegebenen Eigenschaft vom Datendienst asynchron.
Öffentliche Methode BeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object) Lädt asynchron die nächste Seite der verknüpften Entitäten vom Datendienst mit dem angegebenen Abfragefortsetzungsobjekt.
Öffentliche Methode 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.
Öffentliche Methode BeginSaveChanges(AsyncCallback, Object) Übergibt die anstehenden Änderungen asynchron an den von DataServiceContext gesammelten Datendienst seit der letzten Speicherung von Änderungen.
Öffentliche Methode BeginSaveChanges(SaveChangesOptions, AsyncCallback, Object) Übergibt die anstehenden Änderungen asynchron an den von DataServiceContext gesammelten Datendienst seit der letzten Speicherung von Änderungen.
Öffentliche Methode CancelRequest Versucht, den Vorgang abzubrechen, der dem angegebenen IAsyncResult-Objekt zugeordnet ist.
Öffentliche Methode CreateQuery<T> Erstellt eine Datendienstabfrage für Daten eines angegebenen generischen Typs.
Öffentliche Methode DeleteLink Ändert den Status des Links in der Liste, die von DataServiceContext nachverfolgt wird, in Gelöscht.
Öffentliche Methode DeleteObject Ändert den Zustand des angegebenen Objekts, das in DataServiceContext gelöscht werden soll.
Öffentliche Methode Detach Entfernt die Entität aus der Liste der Entitäten, die DataServiceContext nachverfolgt.
Öffentliche Methode DetachLink Entfernt den angegebenen Link aus der Liste der Links, die von DataServiceContext nachverfolgt wird.
Öffentliche Methode EndExecute(IAsyncResult) Wird aufgerufen, um BeginExecute abzuschließen.
Öffentliche Methode EndExecute<TElement>(IAsyncResult) Wird aufgerufen, um BeginExecute abzuschließen.
Öffentliche Methode EndExecuteBatch Wird aufgerufen, um BeginExecuteBatch abzuschließen.
Öffentliche Methode EndGetReadStream Wird aufgerufen, um den asynchronen Vorgang des Abrufs eines binären Datenstroms abzuschließen.
Öffentliche Methode EndLoadProperty Wird aufgerufen, um den BeginLoadProperty-Vorgang abzuschließen.
Öffentliche Methode EndSaveChanges Wird aufgerufen, um den BeginSaveChanges-Vorgang abzuschließen.
Öffentliche Methode Equals (Geerbt von Object.)
Öffentliche Methode Execute(Uri, String, array<OperationParameter[]) Sendet eine Anforderung an den Datendienst, um einen bestimmten URI mithilfe einer bestimmten HTTP-Methode auszuführen.Wird vom WCF Data Services 5.0-Client für Silverlight nicht unterstützt.
Öffentliche Methode Execute<TElement>(Uri) Sendet eine Anforderung an den Datendienst, um einen bestimmten URI auszuführen.Wird vom WCF Data Services 5.0-Client für Silverlight nicht unterstützt.
Öffentliche Methode Execute<T>(DataServiceQueryContinuation<T>) Sendet eine Anforderung an den Datendienst, um die nächste Seite der Daten in einem ausgelagerten Abfrageergebnis abzurufen.Wird vom WCF Data Services 5.0-Client für Silverlight nicht unterstützt.
Öffentliche Methode Execute<TElement>(Uri, String, Boolean, array<OperationParameter[]) Sendet eine Anforderung an den Datendienst, um einen bestimmten URI mithilfe einer bestimmten HTTP-Methode auszuführen.Wird vom WCF Data Services 5.0-Client für Silverlight nicht unterstützt.
Öffentliche Methode ExecuteBatch Sendet synchron eine Gruppe von Abfragen als Batch an den Datendienst.Wird vom WCF Data Services 5.0-Client für Silverlight nicht unterstützt.
Geschützte Methode Finalize (Geerbt von Object.)
Öffentliche Methode GetEntityDescriptor Ruft den EntityDescriptor für das angegebene Entitätsobjekt ab.
Öffentliche Methode GetHashCode (Geerbt von Object.)
Öffentliche Methode GetLinkDescriptor Ruft LinkDescriptor für einen bestimmten Link ab, der die Beziehung zwischen zwei Entitäten definiert.
Öffentliche Methode GetMetadataUri Ruft einen URI des Speicherorts der .edmx-Metadaten ab.
Öffentliche Methode GetReadStream(Object) Ruft den binären Datenstrom ab, der zur angegebenen Entität gehört.Wird vom WCF Data Services 5.0-Client für Silverlight nicht unterstützt.
Öffentliche Methode GetReadStream(Object, DataServiceRequestArgs) Ruft den binären Datenstrom für die angegebene Entität mit den angegebenen Nachrichtenheadern ab.Wird vom WCF Data Services 5.0-Client für Silverlight nicht unterstützt.
Öffentliche Methode GetReadStream(Object, String) Ruft den binären Datenstrom ab, der zur angegebenen Entität gehört (mit dem angegebenen Content-Type-Nachrichtenheader).Wird vom WCF Data Services 5.0-Client für Silverlight nicht unterstützt.
Öffentliche Methode GetReadStream(Object, String, DataServiceRequestArgs) Ruft den benannten binären Datenstrom ab, der zur angegebenen Entität gehört (mit dem angegebenen Content-Type-Nachrichtenheader).Wird vom WCF Data Services 5.0-Client für Silverlight nicht unterstützt.
Öffentliche Methode GetReadStreamUri(Object) Ruft den URI ab, der verwendet wird, um einen binären Datenstrom zurückzugeben.
Öffentliche Methode GetReadStreamUri(Object, String) Ruft den URI ab, der verwendet wird, um einen benannten binären Datenstrom zurückzugeben.
Öffentliche Methode GetType (Geerbt von Object.)
Öffentliche Methode LoadProperty(Object, String) Lädt verzögerte Inhalte für eine angegebene Eigenschaft vom Datendienst.Wird vom WCF Data Services 5.0-Client für Silverlight nicht unterstützt.
Öffentliche Methode LoadProperty(Object, String, DataServiceQueryContinuation) Lädt die nächste Seite der verknüpften Entitäten vom Datendienst mit dem angegebenen Abfragefortsetzungsobjekt.Wird vom WCF Data Services 5.0-Client für Silverlight nicht unterstützt.
Öffentliche Methode LoadProperty(Object, String, Uri) Lädt mit dem angegebenen nächsten Link-URI eine Seite von verknüpften Entitäten.Wird vom WCF Data Services 5.0-Client für Silverlight nicht unterstützt.
Öffentliche Methode LoadProperty<T>(Object, String, DataServiceQueryContinuation<T>) Lädt die nächste Seite der verknüpften Entitäten vom Datendienst mit dem angegebenen generischen Abfragefortsetzungsobjekt.Wird vom WCF Data Services 5.0-Client für Silverlight nicht unterstützt.
Geschützte Methode MemberwiseClone (Geerbt von Object.)
Öffentliche Methode SaveChanges() Speichert die Änderungen, die DataServiceContext zur Speicherung nachverfolgt.Wird vom WCF Data Services 5.0-Client für Silverlight nicht unterstützt.
Öffentliche Methode SaveChanges(SaveChangesOptions) Speichert die Änderungen, die DataServiceContext zur Speicherung nachverfolgt.Wird vom WCF Data Services 5.0-Client für Silverlight nicht unterstützt.
Öffentliche Methode SetLink Benachrichtigt DataServiceContext, dass ein neuer Link zwischen den Objekten vorhanden ist und dass der Link von der vom sourceProperty-Parameter angegebenen Eigenschaft vertreten wird.
Öffentliche Methode SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs) Legt einen binären Datenstrom für die angegebene Entität fest, mit den angegebenen Headern in der Anforderungsmeldung.
Öffentliche Methode SetSaveStream(Object, Stream, Boolean, String, String) Legt einen binären Datenstrom fest, der zur angegebenen Entität gehört, mit dem angegebenen Content-Type und den Slug-Headern in der Anforderungsmeldung.
Öffentliche Methode SetSaveStream(Object, String, Stream, Boolean, DataServiceRequestArgs) Legt einen benannten binären Datenstrom fest, der zur angegebenen Entität gehört, mit den angegebenen Headern in der Anforderungsmeldung.
Öffentliche Methode SetSaveStream(Object, String, Stream, Boolean, String) Legt einen binären Datenstrom für die angegebene Entität fest.
Öffentliche Methode ToString (Geerbt von Object.)
Öffentliche Methode TryGetEntity<TEntity> Testabruf einer Entität, die von DataServiceContext durch Verweis auf den URI der Entität nachverfolgt wird.
Öffentliche Methode TryGetUri Ruft den kanonischen URI der angegebenen Entität ab (falls verfügbar).
Öffentliche Methode UpdateObject Ändert den Zustand des angegebenen Objekts in Modified im DataServiceContext.

Zum Anfang

Ereignisse

  Name Beschreibung
Öffentliches Ereignis ReadingEntity Tritt auf, nachdem Entitätsdaten vollständig in das Entitätsobjekt geladen wurden.
Öffentliches Ereignis SendingRequest Tritt auf, wenn HttpWebRequest neu erstellt wurde.
Öffentliches Ereignis SendingRequest2 Tritt auf, wenn HttpWebRequest neu erstellt wurde.
Öffentliches Ereignis WritingEntity Tritt auf, nachdem eine Entität in einer Anforderungsmeldung vollständig in XML serialisiert wurde.

Zum Anfang

Hinweise

WCF Data Services sind zustandslos, aber DataServiceContext nicht. Der Client-Status bleibt zwischen Interaktionen erhalten, um Funktionen (z. B. die Aktualisierungsverwaltung) 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.

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 erzeugt, wenn Sie den WCF Data Services?Schnellstart durchführen.

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

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Elemente dieses Typs sind Threadsicher. Für Instanzelemente wird die Threadsicherheit nicht gewährleistet.

Siehe auch

Verweis

System.Data.Services.Client-Namespace

Andere Ressourcen

Datenclient (WCF Data Services)