DataServiceContext Klasse

Definition

Der DataServiceContext stellt den Laufzeitkontext des Datendiensts dar.The DataServiceContext represents the runtime context of the data service.

public ref class DataServiceContext
public class DataServiceContext
type DataServiceContext = class
Public Class DataServiceContext
Vererbung
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.The following example shows how to use the DataServiceContext generated by the Add Service Reference tool to implicitly execute a query against the Northwind data service that returns all customers. Der URI der angeforderten Customers-Entitätenmenge wird automatisch vom Kontext bestimmt.The URI of the requested Customers entity set is determined automatically by the context. Die Abfrage wird implizit ausgeführt, wenn die Enumeration auftritt.The query is executed implicitly when the enumeration occurs. Der Northwind-Datendienst wird erstellt, wenn Sie die WCF Data ServicesWCF Data Services vervollständigen.The Northwind data service is created when you complete the WCF Data ServicesWCF Data Services .

// 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 ServicesWCF Data Services sind zustandslos, aber DataServiceContext nicht.are stateless, but the DataServiceContext is not. Der Client-Status bleibt zwischen Interaktionen erhalten, um Funktionen (z. B. die Updateverwaltung) zu unterstützen.State on the client is maintained between interactions in order to support features such as update management. Diese Klasse und die Klasse DataServiceQuery, die eine bestimmte HTTP-Anforderung an einen Datendienst darstellt, sind die beiden Hauptklassen in der Clientbibliothek.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.

Konstruktoren

DataServiceContext(Uri)

Initialisiert eine neue Instanz der DataServiceContext-Klasse mit der angegebenen serviceRoot.Initializes a new instance of the DataServiceContext class with the specified serviceRoot.

Eigenschaften

ApplyingChanges

Ruft einen Wert ab, der angibt, ob DataServiceContext Änderungen für nachverfolgte Objekte übernimmt.Gets a value that indicates whether the DataServiceContext is currently applying changes to tracked objects.

BaseUri

Ruft den absoluten URI ab, der den Stamm des Zieldatendiensts identifiziert.Gets the absolute URI identifying the root of the target data service.

Credentials

Ruft die Authentifizierungsinformationen ab, die von jeder mit dem DataServiceContext-Objekt erstellten Abfrage verwendet werden, oder legt sie fest.Gets or sets the authentication information that is used by each query created by using the DataServiceContext object.

DataNamespace

Ruft den XML-Namespace für Datenelemente, nicht für Metadatenelemente, einer ATOM-Nutzlast ab oder legt diesen fest.Gets or sets the XML namespace for data items, not metadata items, of an Atom payload.

Entities

Ruft eine Liste aller Ressourcen ab, die gerade von DataServiceContext nachverfolgt wird.Gets a list of all the resources currently being tracked by the DataServiceContext.

IgnoreMissingProperties

Ruft ab oder legt fest, ob die vom Typ gelesenen Eigenschaften Eigenschaften des clientseitigen Typs zugeordnet werden müssen.Gets or sets whether the properties read from the type must be mapped to properties on the client-side type.

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.Gets or sets whether an exception is raised when a 404 error (resource not found) is returned by the data service.

Links

Ruft die Auflistung aller Zuordnungen oder Links ab, die derzeit vom DataServiceContext-Objekt überwacht werden.Gets the collection of all associations or links currently being tracked by the DataServiceContext object.

MergeOption

Ruft die Synchronisierungsoption zum Empfangen von Entitäten von einem Datendienst ab oder legt diese fest.Gets or sets the synchronization option for receiving entities from a data service.

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.Gets or sets a function to override the default type resolution strategy used by the client library when you send entities to a data service.

ResolveType

Abrufen/Definieren einer Funktion, die beim Empfangen von Entitäten von einem Datendienst zum Außerkraftsetzen einer Funktion verwendet wird.Gets or sets a function that is used to override the default type resolution option that is used by the client library when receiving entities from a data service.

SaveChangesDefaultOptions

Ruft die von der SaveChangesOptions-Methode verwendeten SaveChanges()-Werte ab oder legt sie fest.Gets or sets the SaveChangesOptions values that are used by the SaveChanges() method.

Timeout

Übernimmt oder bestimmt die Timeoutoption für die zugrunde liegende HTTP-Anforderung an den Datendienst.Gets or sets the time-out option that is used for the underlying HTTP request to the data service.

TypeScheme

Ruft den URI ab, mit dem angegeben wird, welches Typschema der Dienst verwendet, oder legt diesen fest.Gets or sets the URI used to indicate what type scheme is used by the service.

UsePostTunneling

Ruft einen booleschen Wert ab, der angibt, ob Nachtunneling verwendet werden soll, oder legt diesen fest.Gets or sets a Boolean value that indicates whether to use post tunneling.

Methoden

AddLink(Object, String, Object)

Fügt den angegebenen Link dem Satz von Objekten hinzu, den der DataServiceContext nachverfolgt.Adds the specified link to the set of objects the DataServiceContext is tracking.

AddObject(String, Object)

Fügt das angegebene Objekt dem Satz von Objekten hinzu, den der DataServiceContext nachverfolgt.Adds the specified object to the set of objects that the DataServiceContext is tracking.

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.Adds a related object to the context and creates the link that defines the relationship between the two objects in a single request.

AttachLink(Object, String, Object)

Benachrichtigt DataServiceContext, mit der Verfolgung des Links zu beginnen, der eine Beziehung zwischen Entitätsobjekten definiert.Notifies the DataServiceContext to start tracking the specified link that defines a relationship between entity objects.

AttachTo(String, Object)

Benachrichtigt den DataServiceContext, mit der Verfolgung der angegebenen Ressource zu beginnen und gibt die Position der Ressource zum angegebenen Ressourcensatz an.Notifies the DataServiceContext to start tracking the specified resource and supplies the location of the resource within the specified resource set.

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.Notifies the DataServiceContext to start tracking the specified resource and supplies the location of the resource in the specified resource set.

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.Asynchronously sends a request to the data service to retrieve the next page of data in a paged query result.

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.Asynchronously sends the request so that this call does not block processing while waiting for the results from the service.

BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[])

Sendet eine Gruppe von Abfragen asynchron als Batch an den Datendienst.Asynchronously submits a group of queries as a batch to the data service.

BeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object)

Ruft asynchron binäre Eigenschaftendaten für die angegebene Entität zusammen mit den angegebenen Nachrichtenheadern als Datenstrom ab.Asynchronously gets binary property data for the specified entity as a data stream along with the specified message headers.

BeginLoadProperty(Object, String, AsyncCallback, Object)

Lädt den Wert der angegebenen Eigenschaft vom Datendienst asynchron.Asynchronously loads the value of the specified property from the data service.

BeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object)

Lädt asynchron die nächste Seite der verknüpften Entitäten vom Datendienst mit dem angegebenen Abfragefortsetzungsobjekt.Asynchronously loads the next page of related entities from the data service by using the supplied query continuation object.

BeginLoadProperty(Object, String, Uri, AsyncCallback, Object)

Lädt asynchron anhand des angegebenen Weiter-Link-URI eine Seite verknüpfter Entitäten aus dem Datendienst.Asynchronously loads a page of related entities from the data service by using the supplied next link URI.

BeginSaveChanges(AsyncCallback, Object)

Übergibt die anstehenden Änderungen asynchron an den von DataServiceContext gesammelten Datendienst seit der letzten Speicherung von Änderungen.Asynchronously submits the pending changes to the data service collected by the DataServiceContext since the last time changes were saved.

BeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)

Übergibt die anstehenden Änderungen asynchron an den von DataServiceContext gesammelten Datendienst seit der letzten Speicherung von Änderungen.Asynchronously submits the pending changes to the data service collected by the DataServiceContext since the last time changes were saved.

CancelRequest(IAsyncResult)

Versucht, den Vorgang abzubrechen, der dem angegebenen IAsyncResult-Objekt zugeordnet ist.Attempts to cancel the operation that is associated with the supplied IAsyncResult object.

CreateQuery<T>(String)

Erstellt eine Datendienstabfrage für Daten eines angegebenen generischen Typs.Creates a data service query for data of a specified generic type.

DeleteLink(Object, String, Object)

Ändert den Zustand des Links in der Liste, die von DataServiceContext nachverfolgt wird, in Deleted.Changes the state of the link to deleted in the list of links being tracked by the DataServiceContext.

DeleteObject(Object)

Ändert den Zustand des angegebenen Objekts, das in DataServiceContext gelöscht werden soll.Changes the state of the specified object to be deleted in the DataServiceContext.

Detach(Object)

Entfernt die Entität aus der Liste von Entitäten, die vom DataServiceContext überwacht werden.Removes the entity from the list of entities that the DataServiceContext is tracking.

DetachLink(Object, String, Object)

Entfernt den angegebenen Link aus der Liste der Links, die von DataServiceContext nachverfolgt wird.Removes the specified link from the list of links being tracked by the DataServiceContext.

EndExecute<TElement>(IAsyncResult)

Wird aufgerufen, um BeginExecute<TElement>(Uri, AsyncCallback, Object) abzuschließen.Called to complete the BeginExecute<TElement>(Uri, AsyncCallback, Object).

EndExecuteBatch(IAsyncResult)

Wird aufgerufen, um BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[]) abzuschließen.Called to complete the BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[]).

EndGetReadStream(IAsyncResult)

Wird aufgerufen, um den asynchronen Vorgang des Abrufs einer binären Eigenschaft als Datenstrom abzuschließen.Called to complete the asynchronous operation of retrieving a binary property as a stream.

EndLoadProperty(IAsyncResult)

Wird aufgerufen, um den BeginLoadProperty(Object, String, AsyncCallback, Object)-Vorgang abzuschließen.Called to complete the BeginLoadProperty(Object, String, AsyncCallback, Object) operation.

EndSaveChanges(IAsyncResult)

Wird aufgerufen, um den BeginSaveChanges(AsyncCallback, Object)-Vorgang abzuschließen.Called to complete the BeginSaveChanges(AsyncCallback, Object) operation.

Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(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.Sends a request to the data service to retrieve the next page of data in a paged query result.

Execute<TElement>(Uri)

Sendet eine Anforderung an den Datendienst, um einen spezifischen URI auszuführen.Sends a request to the data service to execute a specific URI.

ExecuteBatch(DataServiceRequest[])

Sendet eine Gruppe von Abfragen als Batch an den Datendienst.Submits a group of queries as a batch to the data service.

GetEntityDescriptor(Object)

Ruft die EntityDescriptor für das angegebene Entitätsobjekt ab.Gets the EntityDescriptor for the supplied entity object.

GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetLinkDescriptor(Object, String, Object)

Ruft das LinkDescriptor für einen bestimmten Link ab, der die Beziehung zwischen zwei Entitäten definiert.Gets the LinkDescriptor for a specific link that defines the relationship between two entities.

GetMetadataUri()

Ruft einen URI des Speicherorts der EDMX-Metadaten ab.Gets a URI of the location of .edmx metadata.

GetReadStream(Object)

Ruft binäre Eigenschaftendaten für die angegebene Entität als Datenstrom ab.Gets binary property data for the specified entity as a data stream.

GetReadStream(Object, DataServiceRequestArgs)

Ruft binäre Eigenschaftendaten für die angegebene Entität zusammen mit den angegebenen Nachrichtenheadern als Datenstrom ab.Gets binary property data for the specified entity as a data stream along with the specified message headers.

GetReadStream(Object, String)

Ruft binäre Eigenschaftendaten für die angegebene Entität zusammen mit dem angegebenen Accept-Nachrichtenheader als Datenstrom ab.Gets binary property data for the specified entity as a data stream, with the specified Accept message header.

GetReadStreamUri(Object)

Ruft den URI ab, der verwendet wird, um binäre Eigenschaftendaten als Datenstrom zurückzugeben.Gets the URI that is used to return binary property data as a data stream.

GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
LoadProperty(Object, String)

Lädt verzögerten Inhalt für eine angegebene Eigenschaft aus dem Datendienst.Loads deferred content for a specified property from the data service.

LoadProperty(Object, String, DataServiceQueryContinuation)

Lädt anhand des angegebenen Abfragefortsetzungsobjekts die nächste Seite verknüpfter Entitäten aus dem Datendienst.Loads the next page of related entities from the data service by using the supplied query continuation object.

LoadProperty(Object, String, Uri)

Lädt eine Seite verknüpfter Entitäten anhand des angegebenen Weiter-Link-URI.Loads a page of related entities by using the supplied next link URI.

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

Lädt anhand des angegebenen generischen Abfragefortsetzungsobjekts die nächste Seite verknüpfter Entitäten aus dem Datendienst.Loads the next page of related entities from the data service by using the supplied generic query continuation object.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
SaveChanges()

Speichert die Änderungen, die der DataServiceContext im Speicher überwacht.Saves the changes that the DataServiceContext is tracking to storage.

SaveChanges(SaveChangesOptions)

Speichert die Änderungen, die DataServiceContext zur Speicherung nachverfolgt.Saves the changes that the DataServiceContext is tracking to storage.

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.Notifies the DataServiceContext that a new link exists between the objects specified and that the link is represented by the property specified by the sourceProperty parameter.

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.Sets a new data stream as the binary property of an entity, with the specified settings in the request message.

SetSaveStream(Object, Stream, Boolean, String, String)

Legt einen neuen Datenstrom als binäre Eigenschaft einer Entität fest.Sets a new data stream as the binary property of an entity. Die angegebenen Content-Type- und Slug-Header sind in der Anforderungsnachricht enthalten.The specified Content-Type and Slug headers are included in the request message.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
TryGetEntity<TEntity>(Uri, TEntity)

Testabruf einer vom DataServiceContext überwachten Entität durch Verweis auf den URI der Entität.Test retrieval of an entity being tracked by the DataServiceContext by reference to the URI of the entity.

TryGetUri(Object, Uri)

Ruft den kanonischen URI auf, der der angegebenen Entität zugeordnet ist, falls verfügbar.Retrieves the canonical URI associated with the specified entity, if available.

UpdateObject(Object)

Ändert den Zustand des angegebenen Objekts im DataServiceContext in Modified.Changes the state of the specified object in the DataServiceContext to Modified.

Ereignisse

ReadingEntity

Tritt auf, nachdem Entitätsdaten vollständig in das Entitätsobjekt geladen wurden.Occurs after entity data has been completely read into the entity object.

SendingRequest

Tritt auf, wenn HttpWebRequest neu erstellt wurde.Occurs when a new HttpWebRequest has been created.

WritingEntity

Tritt auf, nachdem eine Entität in einer Anforderungsnachricht vollständig in XML serialisiert wurde.Occurs after an entity has been fully serialized into XML in a request message.

Gilt für:

Siehe auch