DataServiceContext Klasse

Definition

Namespace:
System.Data.Services.Client
Assembly:
System.Data.Services.Client.dll

Dies 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 das DataServiceContext vom Tool "Dienstreferenz hinzufügen" generierte Tool 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 nicht DataServiceContext . Der Status auf dem Client wird zwischen Interaktionen beibehalten, um Features wie die Updateverwaltung zu unterstützen. Diese Klasse und die Klasse, die DataServiceQuery eine bestimmte HTTP-Anforderung an einen Datendienst darstellt, sind die beiden Hauptklassen in der Clientbibliothek.

Konstruktoren

Name Beschreibung
DataServiceContext(Uri)

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

Eigenschaften

Name Beschreibung
ApplyingChanges

Ruft einen Wert ab, der angibt, ob die DataServiceContext Änderungen derzeit auf nachverfolgte Objekte angewendet werden.
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 mit dem DataServiceContext Objekt 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 von der DataServiceContext.
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 DataServiceContext derzeit vom 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

Name Beschreibung
AddLink(Object, String, Object)

Fügt die angegebene Verknüpfung zu der Gruppe von Objekten hinzu, die nachverfolgt DataServiceContext werden.
AddObject(String, Object)

Fügt das angegebene Objekt der Gruppe von Objekten hinzu, die nachverfolgt DataServiceContext 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 Nachverfolgung der angegebenen Verknüpfung, die eine Beziehung zwischen Entitätsobjekten definiert.
AttachTo(String, Object, String)

Benachrichtigt den Anfang der DataServiceContext Nachverfolgung der angegebenen Ressource und stellt den Standort der Ressource im angegebenen Ressourcensatz bereit.
AttachTo(String, Object)

Benachrichtigt den Beginn der DataServiceContext Nachverfolgung der angegebenen Ressource und stellt den Standort der Ressource innerhalb des angegebenen Ressourcensatzes bereit.
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 Datendienst, der DataServiceContext seit dem letzten Speichern von Änderungen gesammelt wurde.
BeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)

Übermittelt asynchron die ausstehenden Änderungen an den Datendienst, der DataServiceContext seit dem letzten Speichern von Änderungen gesammelt wurde.
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 DataServiceContext.
DeleteObject(Object)

Ändert den Zustand des angegebenen Objekts, das gelöscht werden soll.DataServiceContext
Detach(Object)

Entfernt die Entität aus der Liste der Entitäten, die nachverfolgt DataServiceContext werden.
DetachLink(Object, String, Object)

Entfernt den angegebenen Link aus der Liste der Links, die von der DataServiceContext.
EndExecute<TElement>(IAsyncResult)

Wird aufgerufen, um den BeginExecute<TElement>(Uri, AsyncCallback, Object)Vorgang abzuschließen.
EndExecuteBatch(IAsyncResult)

Wird aufgerufen, um den BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[])Vorgang 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 das 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, 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 im DataServiceContext Speicher nachverfolgt werden.
SaveChanges(SaveChangesOptions)

Speichert die Änderungen, die im DataServiceContext Speicher nachverfolgt werden.
SetLink(Object, String, Object)

Benachrichtigt, DataServiceContext dass eine neue Verknüpfung zwischen den angegebenen Objekten vorhanden ist und dass die Verknüpfung durch die durch den sourceProperty Parameter 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 des Abrufs einer Entität, die von dem DataServiceContext durch Verweis auf den URI der Entität nachverfolgt wird.
TryGetUri(Object, Uri)

Ruft den kanonischen URI ab, der der angegebenen Entität zugeordnet ist, falls verfügbar.
UpdateObject(Object)

Ändert den Zustand des angegebenen Objekts in der DataServiceContextModified

Ereignisse

Name Beschreibung
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.

Gilt für:

Weitere Informationen