DataServiceContext Klasse

Definition

Namespace:

System.Data.Services.Client

Assembly:

System.Data.Services.Client.dll

Die 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, wie Sie die vom Tool "Dienstreferenz hinzufügen" generierte DataServiceContext verwenden, um implizit eine Abfrage für den Northwind-Datendienst auszuführen, der alle Kunden zurückgibt. Der URI des angeforderten Customers Entitätssatzes wird automatisch vom Kontext bestimmt. Die Abfrage wird implizit ausgeführt, wenn die Enumeration auftritt. Der Northwind-Datendienst wird erstellt, wenn Sie 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 sind zustandslos, aber die DataServiceContext ist nicht. Der Status auf dem Client wird zwischen Interaktionen beibehalten, um Features wie die Updateverwaltung zu unterstützen. Diese Klasse und die DataServiceQuery Klasse, 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 dem angegebenen serviceRoot.

Eigenschaften

ApplyingChanges	Ruft einen Wert ab, der angibt, ob die DataServiceContext derzeit Änderungen auf nachverfolgte Objekte anwendet.
BaseUri	Ruft den absoluten URI ab, der den Stamm des Zieldatendiensts identifiziert.
Credentials	Dient zum Abrufen oder Festlegen der Authentifizierungsinformationen, die von jeder Abfrage verwendet werden, die mithilfe des DataServiceContext -Objekts erstellt wird.
DataNamespace	Dient zum Abrufen oder Festlegen des XML-Namespace für Datenelemente, nicht Metadatenelemente, einer Atom-Nutzlast.
Entities	Ruft eine Liste aller Ressourcen ab, die derzeit vom DataServiceContextnachverfolgt werden.
IgnoreMissingProperties	Ruft ab oder legt fest, ob die vom Typ gelesenen Eigenschaften eigenschaften für den clientseitigen Typ zugeordnet werden müssen.
IgnoreResourceNotFoundException	Ruft ab oder legt fest, ob eine Ausnahme ausgelöst wird, wenn ein 404-Fehler (Ressource nicht gefunden) vom Datendienst zurückgegeben wird.
Links	Ruft die Auflistung aller Zuordnungen oder Verknüpfungen ab, die derzeit vom DataServiceContext -Objekt nachverfolgt werden.
MergeOption	Dient zum Abrufen oder Festlegen der Synchronisierungsoption für den Empfang von Entitäten von einem Datendienst.
ResolveName	Dient zum Abrufen oder Festlegen einer Funktion zum Außerkraftsetzen der Standardauflösungsstrategie, die von der Clientbibliothek verwendet wird, wenn Sie Entitäten an einen Datendienst senden.
ResolveType	Dient zum Abrufen oder Festlegen einer Funktion, die zum Überschreiben der Standardtypauflösungsoption verwendet wird, die von der Clientbibliothek beim Empfangen von Entitäten von einem Datendienst verwendet wird.
SaveChangesDefaultOptions	Dient zum Abrufen oder Festlegen der SaveChangesOptions Werte, die von der SaveChanges() -Methode verwendet werden.
Timeout	Dient zum Abrufen oder Festlegen der Timeoutoption, die für die zugrunde liegende HTTP-Anforderung an den Datendienst verwendet wird.
TypeScheme	Dient zum Abrufen oder Festlegen des URI, der verwendet wird, um anzugeben, welches Typschema vom Dienst verwendet wird.
UsePostTunneling	Dient zum Abrufen oder Festlegen eines booleschen Werts, der angibt, ob post tunneling verwendet werden soll.

Methoden

AddLink(Object, String, Object)	Fügt die angegebene Verknüpfung zu der Gruppe von Objekten hinzu, die DataServiceContext nachverfolgt wird.
AddObject(String, Object)	Fügt das angegebene Objekt der Gruppe von Objekten hinzu, die vom DataServiceContext nachverfolgt werden.
AddRelatedObject(Object, String, Object)	Fügt dem Kontext ein verknüpftes Objekt hinzu und erstellt die Verknüpfung, die die Beziehung zwischen den beiden Objekten in einer einzigen Anforderung definiert.
AttachLink(Object, String, Object)	Benachrichtigt die DataServiceContext, mit der Nachverfolgung der angegebenen Verknüpfung zu beginnen, die eine Beziehung zwischen Entitätsobjekten definiert.
AttachTo(String, Object, String)	Benachrichtigt die DataServiceContext, mit der Nachverfolgung der angegebenen Ressource zu beginnen und den Standort der Ressource im angegebenen Ressourcensatz anzugeben.
AttachTo(String, Object)	Benachrichtigt die DataServiceContext, mit der Nachverfolgung der angegebenen Ressource zu beginnen und den Standort der Ressource innerhalb des angegebenen Ressourcensatzes anzugeben.
BeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)	Sendet asynchron eine Anforderung an den Datendienst, um die nächste Datenseite in einem seitenseitigen Abfrageergebnis abzurufen.
BeginExecute<TElement>(Uri, AsyncCallback, Object)	Sendet die Anforderung asynchron, sodass dieser Aufruf die Verarbeitung nicht blockiert, während auf die Ergebnisse des Diensts gewartet wird.
BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[])	Sendet asynchron eine Gruppe von Abfragen als Batch an den Datendienst.
BeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object)	Ruft asynchron binäre Eigenschaftsdaten für die angegebene Entität zusammen mit den angegebenen Nachrichtenkopfzeilen als Datenstrom ab.
BeginLoadProperty(Object, String, AsyncCallback, Object)	Lädt asynchron den Wert der angegebenen Eigenschaft aus dem Datendienst.
BeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object)	Lädt asynchron die nächste Seite verwandter Entitäten aus dem Datendienst mithilfe des bereitgestellten Abfragefortsetzungsobjekts.
BeginLoadProperty(Object, String, Uri, AsyncCallback, Object)	Lädt asynchron eine Seite verwandter Entitäten aus dem Datendienst mithilfe des bereitgestellten nächsten Link-URI.
BeginSaveChanges(AsyncCallback, Object)	Übermittelt asynchron die ausstehenden Änderungen an den vom DataServiceContext gesammelten Datendienst seit dem letzten Speichern von Änderungen.
BeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)	Übermittelt asynchron die ausstehenden Änderungen an den vom DataServiceContext gesammelten Datendienst seit dem letzten Speichern 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 Status des Links, der in der Liste der Links gelöscht wird, die von der DataServiceContextnachverfolgt werden.
DeleteObject(Object)	Ändert den Zustand des angegebenen Objekts, das im DataServiceContextgelöscht werden soll.
Detach(Object)	Entfernt die Entität aus der Liste der Entitäten, die der DataServiceContext nachverfolgt.
DetachLink(Object, String, Object)	Entfernt den angegebenen Link aus der Liste der Links, die vom DataServiceContextnachverfolgt werden.
EndExecute<TElement>(IAsyncResult)	Wird aufgerufen, um die BeginExecute<TElement>(Uri, AsyncCallback, Object)abzuschließen.
EndExecuteBatch(IAsyncResult)	Wird aufgerufen, um die BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[])abzuschließen.
EndGetReadStream(IAsyncResult)	Wird aufgerufen, um den asynchronen Vorgang zum Abrufen 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 dem aktuellen Objekt entspricht. (Geerbt von Object)
Execute<T>(DataServiceQueryContinuation<T>)	Sendet eine Anforderung an den Datendienst, um die nächste Seite mit Daten in einem seitenseitigen 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 die EntityDescriptor für das angegebene Entitätsobjekt ab.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetLinkDescriptor(Object, String, Object)	Ruft die LinkDescriptor für eine bestimmte Verknüpfung ab, die die Beziehung zwischen zwei Entitäten definiert.
GetMetadataUri()	Ruft einen URI des Speicherorts von edmx-Metadaten ab.
GetReadStream(Object, DataServiceRequestArgs)	Ruft binäre Eigenschaftsdaten für die angegebene Entität als Datenstrom zusammen mit den angegebenen Nachrichtenkopfzeilen ab.
GetReadStream(Object, String)	Ruft binäre Eigenschaftsdaten für die angegebene Entität als Datenstrom mit dem angegebenen Accept-Nachrichtenkopf ab.
GetReadStream(Object)	Ruft binäre Eigenschaftsdaten für die angegebene Entität als Datenstrom ab.
GetReadStreamUri(Object)	Ruft den URI ab, der verwendet wird, um binäre Eigenschaftsdaten als Datenstrom zurückzugeben.
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
LoadProperty(Object, String, DataServiceQueryContinuation)	Lädt die nächste Seite verwandter Entitäten aus dem Datendienst mithilfe des bereitgestellten Abfragefortsetzungsobjekts.
LoadProperty(Object, String, Uri)	Lädt eine Seite verwandter Entitäten mithilfe des bereitgestellten nächsten Link-URI.
LoadProperty(Object, String)	Lädt verzögerten Inhalt für eine angegebene Eigenschaft aus dem Datendienst.
LoadProperty<T>(Object, String, DataServiceQueryContinuation<T>)	Lädt die nächste Seite verwandter Entitäten aus dem Datendienst mithilfe des bereitgestellten generischen Abfragefortsetzungsobjekts.
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
SaveChanges()	Speichert die Änderungen, die der DataServiceContext auf den Speicher nachverfolgt.
SaveChanges(SaveChangesOptions)	Speichert die Änderungen, die der DataServiceContext auf den Speicher nachverfolgt.
SetLink(Object, String, Object)	Benachrichtigt die DataServiceContext, dass eine neue Verknüpfung zwischen den angegebenen Objekten vorhanden ist und dass die Verknüpfung durch die durch den parameter sourceProperty angegebene Eigenschaft dargestellt wird.
SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)	Legt einen neuen Datenstrom als binäre Eigenschaft einer Entität fest, wobei die angegebenen Einstellungen in der Anforderungsnachricht angegeben sind.
SetSaveStream(Object, Stream, Boolean, String, String)	Legt einen neuen Datenstrom als binäre Eigenschaft einer Entität fest. Die angegebenen Inhaltstyp- und Slug-Kopfzeilen sind in der Anforderungsnachricht enthalten.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
TryGetEntity<TEntity>(Uri, TEntity)	Testen Sie den Abruf einer Entität, die vom DataServiceContext nachverfolgt wird, indem Sie auf den URI der Entität verweisen.
TryGetUri(Object, Uri)	Ruft den kanonischen URI ab, der der angegebenen Entität zugeordnet ist, falls verfügbar.
UpdateObject(Object)	Ändert den Status des angegebenen Objekts im DataServiceContext in Modified.

Ereignisse

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

Weitere Informationen

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