Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

DataServiceContext-Klasse

 

Veröffentlicht: Oktober 2016

Der DataServiceContext stellt den Laufzeitkontext des Datendiensts dar.

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

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

public class DataServiceContext

NameBeschreibung
System_CAPS_pubmethodDataServiceContext(Uri)

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

NameBeschreibung
System_CAPS_pubpropertyApplyingChanges

Ruft einen Wert ab, der angibt, ob DataServiceContext Änderungen für nachverfolgte Objekte übernimmt.

System_CAPS_pubpropertyBaseUri

Ruft den absoluten URI ab, der den Stamm des Zieldatendiensts identifiziert.

System_CAPS_pubpropertyCredentials

Ruft die Authentifizierungsinformationen ab, die von jeder mit dem DataServiceContext-Objekt erstellten Abfrage verwendet werden, oder legt sie fest.

System_CAPS_pubpropertyDataNamespace

Ruft den XML-Namespace für Datenelemente (nicht Metadatenelemente) eines Atom-Stoms ab oder legt ihn fest.

System_CAPS_pubpropertyEntities

Ruft eine Liste aller Ressourcen ab, die gerade von DataServiceContext nachverfolgt wird.

System_CAPS_pubpropertyIgnoreMissingProperties

Abrufen/Definieren, ob vom Typ gelesene Eigenschaften dem clientseitigen Typ zugeordnet werden müssen.

System_CAPS_pubpropertyIgnoreResourceNotFoundException

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.

System_CAPS_pubpropertyLinks

Ruft die Auflistung aller Zuordnungen oder Links ab, die gerade durch das DataServiceContext-Objekt verfolgt werden.

System_CAPS_pubpropertyMergeOption

Ruft die Synchronisierungsoption zum Empfangen von Entitäten von einem Datendienst ab oder legt sie fest.

System_CAPS_pubpropertyResolveName

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.

System_CAPS_pubpropertyResolveType

Abrufen/Definieren einer Funktion, die beim Empfangen von Entitäten von einem Datendienst zum Außerkraftsetzen einer Funktion verwendet wird.

System_CAPS_pubpropertySaveChangesDefaultOptions

Abrufen/Definieren der SaveChangesOptions-Werte, die von der Methode SaveChanges verwendet werden.

System_CAPS_pubpropertyTimeout

Ruft ab oder legt die Timeoutoption, die für die zugrunde liegende HTTP-Anforderung an den Datendienst verwendet wird.

System_CAPS_pubpropertyTypeScheme

Abrufen/Definieren des URI ab, der verwendet wurde, um das Typschema des Diensts anzugeben.

System_CAPS_pubpropertyUsePostTunneling

Ruft einen booleschen Wert ab, der angibt, ob Nachtunneln verwendet wird.

NameBeschreibung
System_CAPS_pubmethodAddLink(Object, String, Object)

Fügt den angegebenen Link dem Satz von Objekten hinzu, den der DataServiceContext nachverfolgt.

System_CAPS_pubmethodAddObject(String, Object)

Fügt das angegebene Objekt dem Satz von Objekten hinzu, den der DataServiceContext nachverfolgt.

System_CAPS_pubmethodAddRelatedObject(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.

System_CAPS_pubmethodAttachLink(Object, String, Object)

Benachrichtigt DataServiceContext, mit der Verfolgung des Links zu beginnen, der eine Beziehung zwischen Entitätsobjekten definiert.

System_CAPS_pubmethodAttachTo(String, Object)

Benachrichtigt den DataServiceContext, mit der Verfolgung der angegebenen Ressource zu beginnen und gibt die Position der Ressource zum angegebenen Ressourcensatz an.

System_CAPS_pubmethodAttachTo(String, Object, String)

Benachrichtigt den DataServiceContext, mit der Verfolgung der angegebenen Ressource zu beginnen und gibt die Position der Ressource zum angegebenen Ressourcensatz an.

System_CAPS_pubmethodBeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)

Sendet asynchron eine Anforderung an den Datendienst, um die nächste Seite der Daten in einem ausgelagerten Abfrageergebnis abzurufen.

System_CAPS_pubmethodBeginExecute<TElement>(Uri, AsyncCallback, Object)

Asynchron sendet die Anforderung, damit dieser Aufruf beim Warten auf die Ergebnisse vom Dienst keine Verarbeitung blockiert.

System_CAPS_pubmethodBeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[])

Sendet asynchron eine Gruppe von Abfragen als Batch an den Datendienst.

System_CAPS_pubmethodBeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object)

Asynchron ruft binäre Eigenschaftendaten für die angegebene Entität als Datenstrom zusammen mit den angegebenen Nachrichtenheadern ab.

System_CAPS_pubmethodBeginLoadProperty(Object, String, AsyncCallback, Object)

Lädt den Wert der angegebenen Eigenschaft vom Datendienst asynchron.

System_CAPS_pubmethodBeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object)

Lädt asynchron die nächste Seite der verknüpften Entitäten vom Datendienst mit dem angegebenen Abfragefortsetzungsobjekt.

System_CAPS_pubmethodBeginLoadProperty(Object, String, Uri, AsyncCallback, Object)

Lädt asynchron mit dem angegebenen nächsten Link-URI eine Seite der verknüpften Entitäten vom Datendienst.

System_CAPS_pubmethodBeginSaveChanges(AsyncCallback, Object)

Übergibt die anstehenden Änderungen asynchron an den von DataServiceContext gesammelten Datendienst seit der letzten Speicherung von Änderungen.

System_CAPS_pubmethodBeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)

Übergibt die anstehenden Änderungen asynchron an den von DataServiceContext gesammelten Datendienst seit der letzten Speicherung von Änderungen.

System_CAPS_pubmethodCancelRequest(IAsyncResult)

Versucht, den Vorgang abzubrechen, der dem angegebenen IAsyncResult-Objekt zugeordnet ist.

System_CAPS_pubmethodCreateQuery<T>(String)

Erstellt eine Datendienstabfrage für Daten eines angegebenen generischen Typs.

System_CAPS_pubmethodDeleteLink(Object, String, Object)

Ändert den Zustand des Links in der Liste, die von DataServiceContext nachverfolgt wird, in Deleted.

System_CAPS_pubmethodDeleteObject(Object)

Ändert den Zustand des angegebenen Objekts, das in DataServiceContext gelöscht werden soll.

System_CAPS_pubmethodDetach(Object)

Entfernt die Entität aus der Liste der Entitäten, die DataServiceContext nachverfolgt.

System_CAPS_pubmethodDetachLink(Object, String, Object)

Entfernt den angegebenen Link aus der Liste der Links, die von DataServiceContext nachverfolgt wird.

System_CAPS_pubmethodEndExecute<TElement>(IAsyncResult)

Wird aufgerufen, um BeginExecute<TElement> abzuschließen.

System_CAPS_pubmethodEndExecuteBatch(IAsyncResult)

Wird aufgerufen, um BeginExecuteBatch abzuschließen.

System_CAPS_pubmethodEndGetReadStream(IAsyncResult)

Wird aufgerufen, um den asynchronen Vorgang des Abrufs einer binären Eigenschaft als Datenstrom abzuschließen.

System_CAPS_pubmethodEndLoadProperty(IAsyncResult)

Wird aufgerufen, um den BeginLoadProperty-Vorgang abzuschließen.

System_CAPS_pubmethodEndSaveChanges(IAsyncResult)

Wird aufgerufen, um den BeginSaveChanges-Vorgang abzuschließen.

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_pubmethodExecute<T>(DataServiceQueryContinuation<T>)

Sendet eine Anforderung an den Datendienst, um die nächste Seite der Daten in einem ausgelagerten Abfrageergebnis abzurufen.

System_CAPS_pubmethodExecute<TElement>(Uri)

Sendet eine Anforderung an den Datendienst, um einen bestimmten URI auszuführen.

System_CAPS_pubmethodExecuteBatch(DataServiceRequest[])

Sendet eine Gruppe von Abfragen als Batch an den Datendienst.

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Geerbt von „Object“.)

System_CAPS_pubmethodGetEntityDescriptor(Object)

Ruft den EntityDescriptor für das angegebene Entitätsobjekt ab.

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetLinkDescriptor(Object, String, Object)

Ruft LinkDescriptor für einen bestimmten Link ab, der die Beziehung zwischen zwei Entitäten definiert.

System_CAPS_pubmethodGetMetadataUri()

Ruft einen URI des Speicherorts der .edmx-Metadaten ab.

System_CAPS_pubmethodGetReadStream(Object)

Ruft binäre Eigenschaftendaten für die angegebene Entität als Datenstrom ab.

System_CAPS_pubmethodGetReadStream(Object, DataServiceRequestArgs)

Ruft binäre Eigenschaftendaten für die angegebene Entität als Datenstrom zusammen mit den angegebenen Nachrichtenheadern ab.

System_CAPS_pubmethodGetReadStream(Object, String)

Ruft binäre Eigenschaftendaten für die angegebene Entität als Datenstrom, mit dem angegebenen Accept-Nachrichtenheader ab.

System_CAPS_pubmethodGetReadStreamUri(Object)

Ruft den URI, der verwendet wird, um binäre Eigenschaftendaten als Datenstrom zurückzugeben.

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodLoadProperty(Object, String)

Lädt verzögerte Inhalte für eine angegebene Eigenschaft vom Datendienst.

System_CAPS_pubmethodLoadProperty(Object, String, DataServiceQueryContinuation)

Lädt die nächste Seite der verknüpften Entitäten vom Datendienst mit dem angegebenen Abfragefortsetzungsobjekt.

System_CAPS_pubmethodLoadProperty(Object, String, Uri)

Lädt mit dem angegebenen nächsten Link-URI eine Seite von verknüpften Entitäten.

System_CAPS_pubmethodLoadProperty<T>(Object, String, DataServiceQueryContinuation<T>)

Lädt die nächste Seite der verknüpften Entitäten vom Datendienst mit dem angegebenen generischen Abfragefortsetzungsobjekt.

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_pubmethodSaveChanges()

Speichert die Änderungen, die DataServiceContext zur Speicherung nachverfolgt.

System_CAPS_pubmethodSaveChanges(SaveChangesOptions)

Speichert die Änderungen, die DataServiceContext zur Speicherung nachverfolgt.

System_CAPS_pubmethodSetLink(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.

System_CAPS_pubmethodSetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)

Legt einen neuen Datenstrom als binäre Eigenschaft einer Entität, mit den angegebenen Einstellungen in der Anforderungsnachricht fest.

System_CAPS_pubmethodSetSaveStream(Object, Stream, Boolean, String, String)

Legt einen neuen Datenstrom als binäre Eigenschaft einer Entität fest. Der angegebene Content-Type und Slug-Header sind in der Anforderungsnachricht enthalten.

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

System_CAPS_pubmethodTryGetEntity<TEntity>(Uri, TEntity)

Testabruf einer Entität, die von DataServiceContext durch Verweis auf den URI der Entität nachverfolgt wird.

System_CAPS_pubmethodTryGetUri(Object, Uri)

Ruft den kanonischen URI der angegebenen Entität ab (falls verfügbar).

System_CAPS_pubmethodUpdateObject(Object)

Ändert den Zustand des angegebenen Objekts in DataServiceContext im Modified.

NameBeschreibung
System_CAPS_pubeventReadingEntity

Tritt auf, nachdem Entitätsdaten vollständig in das Entitätsobjekt geladen wurden.

System_CAPS_pubeventSendingRequest

Tritt auf, wenn HttpWebRequest neu erstellt wurde.

System_CAPS_pubeventWritingEntity

Tritt auf, nachdem eine Entität in einer Anforderungsnachricht vollständig in XML serialisiert wurde.

WCF Data Services are stateless, but the DataServiceContext is not. State on the client is maintained between interactions in order to support features such as update management. This class, and the DataServiceQuery class that represents a particular HTTP request to a data service, are the two main classes in the client library.

The following example shows how to use the T:System.Data.Services.Client.DataServiceContext generated by the Add Service Reference tool to implicitly execute a query against the Northwind data service that returns all customers. The URI of the requested Customers entity set is determined automatically by the context. The query is executed implicitly when the enumeration occurs. The Northwind data service is created when you complete the ssAstoria .

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

.NET Framework
Verfügbar seit 3.5
Silverlight
Verfügbar seit 2.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: