DataServiceContext Klas

Definitie

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

Het DataServiceContext vertegenwoordigt de runtimecontext van de gegevensservice.

public ref class DataServiceContext
public class DataServiceContext
type DataServiceContext = class
Public Class DataServiceContext
Overname
Object
DataServiceContext

Voorbeelden

In het volgende voorbeeld ziet u hoe u de DataServiceContext gegenereerde door het hulpprogramma Servicereferentie toevoegen kunt gebruiken om impliciet een query uit te voeren op de Northwind-gegevensservice die alle klanten retourneert. De URI van de aangevraagde Customers entiteitsset wordt automatisch bepaald door de context. De query wordt impliciet uitgevoerd wanneer de opsomming plaatsvindt. De Northwind-gegevensservice wordt gemaakt wanneer u de WCF Data Services voltooit.

// 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

Opmerkingen

WCF Data Services zijn staatloos, maar dat DataServiceContext is niet het. Status op de client wordt onderhouden tussen interacties om functies zoals updatebeheer te ondersteunen. Deze klasse en de DataServiceQuery klasse die een bepaalde HTTP-aanvraag voor een gegevensservice vertegenwoordigt, zijn de twee hoofdklassen in de clientbibliotheek.

Constructors

Name Description
DataServiceContext(Uri)

Initialiseert een nieuw exemplaar van de DataServiceContext klasse met de opgegeven serviceRoot.

Eigenschappen

Name Description
ApplyingChanges

Hiermee wordt een waarde opgehaald die aangeeft of er DataServiceContext momenteel wijzigingen worden toegepast op bijgehouden objecten.
BaseUri

Haalt de absolute URI op die de hoofdmap van de doelgegevensservice identificeert.
Credentials

Hiermee haalt u de verificatiegegevens op die worden gebruikt door elke query die is gemaakt met behulp van het DataServiceContext object.
DataNamespace

Hiermee wordt de XML-naamruimte opgehaald of ingesteld voor gegevensitems, niet metagegevensitems, van een Atom-nettolading.
Entities

Hiermee haalt u een lijst op van alle resources die momenteel worden bijgehouden door de DataServiceContext.
IgnoreMissingProperties

Hiermee wordt opgehaald of ingesteld of de eigenschappen die van het type worden gelezen, moeten worden toegewezen aan eigenschappen aan de clientzijde.
IgnoreResourceNotFoundException

Hiermee wordt opgehaald of ingesteld of er een uitzondering wordt gegenereerd wanneer een 404-fout (resource niet gevonden) wordt geretourneerd door de gegevensservice.
Links

Hiermee haalt u de verzameling van alle koppelingen of koppelingen op die momenteel door het DataServiceContext object worden bijgehouden.
MergeOption

Hiermee haalt u de synchronisatieoptie voor het ontvangen van entiteiten van een gegevensservice op of stelt u deze in.
ResolveName

Hiermee haalt u een functie op of stelt u een functie in om de standaardstrategie voor het oplossen van typen te overschrijven die door de clientbibliotheek wordt gebruikt wanneer u entiteiten naar een gegevensservice verzendt.
ResolveType

Hiermee haalt u een functie op die wordt gebruikt om de standaardoptie voor typeomzetting te overschrijven die door de clientbibliotheek wordt gebruikt bij het ontvangen van entiteiten van een gegevensservice.
SaveChangesDefaultOptions

Hiermee haalt u de SaveChangesOptions waarden op die door de methode worden gebruikt of stelt u deze SaveChanges() in.
Timeout

Hiermee wordt de time-outoptie opgehaald of ingesteld die wordt gebruikt voor de onderliggende HTTP-aanvraag voor de gegevensservice.
TypeScheme

Hiermee haalt u de URI op die wordt gebruikt om aan te geven welk type schema wordt gebruikt door de service.
UsePostTunneling

Hiermee wordt een Booleaanse waarde opgehaald of ingesteld die aangeeft of er posttunneling moet worden gebruikt.

Methoden

Name Description
AddLink(Object, String, Object)

Hiermee voegt u de opgegeven koppeling toe aan de set objecten die het DataServiceContext bijhouden is.
AddObject(String, Object)

Hiermee voegt u het opgegeven object toe aan de set objecten die door de DataServiceContext tracering worden bijgehouden.
AddRelatedObject(Object, String, Object)

Hiermee voegt u een gerelateerd object toe aan de context en maakt u de koppeling waarmee de relatie tussen de twee objecten in één aanvraag wordt gedefinieerd.
AttachLink(Object, String, Object)

Hiermee wordt aangegeven dat de DataServiceContext opgegeven koppeling wordt bijgehouden waarmee een relatie tussen entiteitsobjecten wordt gedefinieerd.
AttachTo(String, Object, String)

Hiermee wordt DataServiceContext aangegeven dat de opgegeven resource wordt bijgehouden en wordt de locatie van de resource in de opgegeven resourceset geleverd.
AttachTo(String, Object)

Hiermee wordt aangegeven dat de DataServiceContext opgegeven resource wordt bijgehouden en wordt de locatie van de resource binnen de opgegeven resourceset geleverd.
BeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)

Asynchroon verzendt een aanvraag naar de gegevensservice om de volgende pagina met gegevens op te halen in een gepaginad queryresultaat.
BeginExecute<TElement>(Uri, AsyncCallback, Object)

De aanvraag wordt asynchroon verzonden, zodat deze aanroep de verwerking niet blokkeert terwijl wordt gewacht op de resultaten van de service.
BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[])

Asynchroon verzendt een groep query's als batch naar de gegevensservice.
BeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object)

Asynchroon haalt binaire eigenschapsgegevens op voor de opgegeven entiteit als een gegevensstroom, samen met de opgegeven berichtkoppen.
BeginLoadProperty(Object, String, AsyncCallback, Object)

Laad de waarde van de opgegeven eigenschap asynchroon vanuit de gegevensservice.
BeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object)

Laadt asynchroon de volgende pagina met gerelateerde entiteiten uit de gegevensservice met behulp van het opgegeven queryvervolgobject.
BeginLoadProperty(Object, String, Uri, AsyncCallback, Object)

Asynchroon laadt een pagina met gerelateerde entiteiten uit de gegevensservice met behulp van de opgegeven volgende koppelings-URI.
BeginSaveChanges(AsyncCallback, Object)

De wijzigingen die in behandeling zijn, worden asynchroon verzonden naar de gegevensservice die is verzameld door de DataServiceContext laatste keer dat wijzigingen zijn opgeslagen.
BeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)

De wijzigingen die in behandeling zijn, worden asynchroon verzonden naar de gegevensservice die is verzameld door de DataServiceContext laatste keer dat wijzigingen zijn opgeslagen.
CancelRequest(IAsyncResult)

Hiermee wordt geprobeerd de bewerking te annuleren die is gekoppeld aan het opgegeven IAsyncResult object.
CreateQuery<T>(String)

Hiermee maakt u een gegevensservicequery voor gegevens van een opgegeven algemeen type.
DeleteLink(Object, String, Object)

Hiermee wijzigt u de status van de koppeling die moet worden verwijderd in de lijst met koppelingen die door de DataServiceContextkoppeling worden bijgehouden.
DeleteObject(Object)

Hiermee wijzigt u de status van het opgegeven object dat moet worden verwijderd in de DataServiceContext.
Detach(Object)

Hiermee verwijdert u de entiteit uit de lijst met entiteiten die door de DataServiceContext entiteit worden bijgehouden.
DetachLink(Object, String, Object)

Hiermee verwijdert u de opgegeven koppeling uit de lijst met koppelingen die worden bijgehouden door de DataServiceContext.
EndExecute<TElement>(IAsyncResult)

Aangeroepen om de BeginExecute<TElement>(Uri, AsyncCallback, Object).
EndExecuteBatch(IAsyncResult)

Aangeroepen om de BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[]).
EndGetReadStream(IAsyncResult)

Aangeroepen om de asynchrone bewerking van het ophalen van een binaire eigenschap als een stroom te voltooien.
EndLoadProperty(IAsyncResult)

Aangeroepen om de BeginLoadProperty(Object, String, AsyncCallback, Object) bewerking te voltooien.
EndSaveChanges(IAsyncResult)

Aangeroepen om de BeginSaveChanges(AsyncCallback, Object) bewerking te voltooien.
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
Execute<T>(DataServiceQueryContinuation<T>)

Hiermee wordt een aanvraag naar de gegevensservice verzonden om de volgende pagina met gegevens op te halen in een gepaginad queryresultaat.
Execute<TElement>(Uri)

Verzendt een aanvraag naar de gegevensservice om een specifieke URI uit te voeren.
ExecuteBatch(DataServiceRequest[])

Hiermee verzendt u een groep query's als een batch naar de gegevensservice.
GetEntityDescriptor(Object)

Hiermee haalt u het EntityDescriptor voor het opgegeven entiteitsobject op.
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetLinkDescriptor(Object, String, Object)

Hiermee haalt u de LinkDescriptor voor een specifieke koppeling op waarmee de relatie tussen twee entiteiten wordt gedefinieerd.
GetMetadataUri()

Hiermee haalt u een URI op van de locatie van .edmx-metagegevens.
GetReadStream(Object, DataServiceRequestArgs)

Hiermee worden binaire eigenschapsgegevens voor de opgegeven entiteit opgehaald als gegevensstroom, samen met de opgegeven berichtkoppen.
GetReadStream(Object, String)

Hiermee worden binaire eigenschapsgegevens opgehaald voor de opgegeven entiteit als gegevensstroom, met de opgegeven berichtkop Accepteren.
GetReadStream(Object)

Hiermee worden binaire eigenschapsgegevens voor de opgegeven entiteit opgehaald als een gegevensstroom.
GetReadStreamUri(Object)

Hiermee haalt u de URI op die wordt gebruikt om binaire eigenschapsgegevens als gegevensstroom te retourneren.
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
LoadProperty(Object, String, DataServiceQueryContinuation)

Laadt de volgende pagina met gerelateerde entiteiten uit de gegevensservice met behulp van het opgegeven queryvervolgobject.
LoadProperty(Object, String, Uri)

Laadt een pagina met gerelateerde entiteiten met behulp van de opgegeven volgende koppelings-URI.
LoadProperty(Object, String)

Laadt uitgestelde inhoud voor een opgegeven eigenschap van de gegevensservice.
LoadProperty<T>(Object, String, DataServiceQueryContinuation<T>)

Laadt de volgende pagina met gerelateerde entiteiten uit de gegevensservice met behulp van het opgegeven algemene queryvervolgobject.
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
SaveChanges()

Hiermee worden de wijzigingen opgeslagen die door de DataServiceContext opslag worden bijgehouden.
SaveChanges(SaveChangesOptions)

Hiermee worden de wijzigingen opgeslagen die door de DataServiceContext opslag worden bijgehouden.
SetLink(Object, String, Object)

Hiermee wordt aangegeven DataServiceContext dat er een nieuwe koppeling bestaat tussen de opgegeven objecten en of de koppeling wordt vertegenwoordigd door de eigenschap die is opgegeven door de sourceProperty parameter.
SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)

Hiermee stelt u een nieuwe gegevensstroom in als de binaire eigenschap van een entiteit, met de opgegeven instellingen in het aanvraagbericht.
SetSaveStream(Object, Stream, Boolean, String, String)

Hiermee stelt u een nieuwe gegevensstroom in als de binaire eigenschap van een entiteit. De opgegeven inhoudstype- en slug-headers worden opgenomen in het aanvraagbericht.
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)
TryGetEntity<TEntity>(Uri, TEntity)

Test het ophalen van een entiteit die wordt bijgehouden door de DataServiceContext door verwijzing naar de URI van de entiteit.
TryGetUri(Object, Uri)

Haalt de canonieke URI op die is gekoppeld aan de opgegeven entiteit, indien beschikbaar.
UpdateObject(Object)

Hiermee wijzigt u de status van het opgegeven object in het DataServiceContext object in Modified.

gebeurtenis

Name Description
ReadingEntity

Treedt op nadat entiteitsgegevens volledig zijn ingelezen in het entiteitsobject.
SendingRequest

Treedt op wanneer er een nieuwe HttpWebRequest is gemaakt.
WritingEntity

Vindt plaats nadat een entiteit volledig is geserialiseerd in XML in een aanvraagbericht.

Van toepassing op

Zie ook