DataServiceContext Klass

Definition

Namnområde:
System.Data.Services.Client
Sammansättning:
System.Data.Services.Client.dll

DataServiceContext Representerar körningskontexten för datatjänsten.

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

Exempel

I följande exempel visas hur du använder det DataServiceContext som genereras av verktyget Lägg till tjänstreferens för att implicit köra en fråga mot Northwind-datatjänsten som returnerar alla kunder. URI:n för den begärda Customers entitetsuppsättningen bestäms automatiskt av kontexten. Frågan körs implicit när uppräkningen inträffar. Northwind-datatjänsten skapas när du slutför WCF 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

Kommentarer

WCF Data Services är tillståndslösa, men det är det DataServiceContext inte. Tillståndet på klienten upprätthålls mellan interaktioner för att stödja funktioner som uppdateringshantering. Den här klassen och den DataServiceQuery klass som representerar en viss HTTP-begäran till en datatjänst är de två huvudklasserna i klientbiblioteket.

Konstruktorer

Name Description
DataServiceContext(Uri)

Initierar en ny instans av DataServiceContext klassen med angiven serviceRoot.

Egenskaper

Name Description
ApplyingChanges

Hämtar ett värde som anger om DataServiceContext ändringarna för närvarande tillämpas på spårade objekt.
BaseUri

Hämtar den absoluta URI:n som identifierar roten för måldatatjänsten.
Credentials

Hämtar eller anger den autentiseringsinformation som används av varje fråga som skapas med hjälp DataServiceContext av objektet.
DataNamespace

Hämtar eller anger XML-namnområdet för dataobjekt, inte metadataobjekt, för en Atom-nyttolast.
Entities

Hämtar en lista över alla resurser som för närvarande spåras av DataServiceContext.
IgnoreMissingProperties

Hämtar eller anger om egenskaperna som läss från typen måste mappas till egenskaper på klientsidans typ.
IgnoreResourceNotFoundException

Hämtar eller anger om ett undantag utlöses när ett 404-fel (resursen hittades inte) returneras av datatjänsten.
Links

Hämtar samlingen med alla associationer eller länkar som för närvarande spåras av DataServiceContext objektet.
MergeOption

Hämtar eller anger synkroniseringsalternativet för att ta emot entiteter från en datatjänst.
ResolveName

Hämtar eller anger en funktion för att åsidosätta den standardtypmatchningsstrategi som används av klientbiblioteket när du skickar entiteter till en datatjänst.
ResolveType

Hämtar eller anger en funktion som används för att åsidosätta standardalternativet för typmatchning som används av klientbiblioteket när entiteter tas emot från en datatjänst.
SaveChangesDefaultOptions

Hämtar eller anger de SaveChangesOptions värden som används av SaveChanges() metoden.
Timeout

Hämtar eller anger timeout-alternativet som används för den underliggande HTTP-begäran till datatjänsten.
TypeScheme

Hämtar eller anger den URI som används för att ange vilket typschema som används av tjänsten.
UsePostTunneling

Hämtar eller anger ett booleskt värde som anger om posttunnel ska användas.

Metoder

Name Description
AddLink(Object, String, Object)

Lägger till den angivna länken till den uppsättning objekt som DataServiceContext spåras.
AddObject(String, Object)

Lägger till det angivna objektet i den uppsättning objekt som DataServiceContext spåras.
AddRelatedObject(Object, String, Object)

Lägger till ett relaterat objekt i kontexten och skapar länken som definierar relationen mellan de två objekten i en enda begäran.
AttachLink(Object, String, Object)

Meddelar DataServiceContext att du ska börja spåra den angivna länken som definierar en relation mellan entitetsobjekt.
AttachTo(String, Object, String)

Meddelar DataServiceContext att du ska börja spåra den angivna resursen och tillhandahåller platsen för resursen i den angivna resursuppsättningen.
AttachTo(String, Object)

DataServiceContext Meddelar för att börja spåra den angivna resursen och tillhandahåller platsen för resursen i den angivna resursuppsättningen.
BeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)

Skickar asynkront en begäran till datatjänsten för att hämta nästa sida med data i ett sidigt frågeresultat.
BeginExecute<TElement>(Uri, AsyncCallback, Object)

Skickar begäran asynkront så att det här anropet inte blockerar bearbetningen i väntan på resultatet från tjänsten.
BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[])

Skickar asynkront en grupp frågor som en batch till datatjänsten.
BeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object)

Asynkront hämtar binära egenskapsdata för den angivna entiteten som en dataström tillsammans med de angivna meddelandehuvudena.
BeginLoadProperty(Object, String, AsyncCallback, Object)

Läser asynkront in värdet för den angivna egenskapen från datatjänsten.
BeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object)

Läser asynkront in nästa sida med relaterade entiteter från datatjänsten med hjälp av det angivna frågefortsättningsobjektet.
BeginLoadProperty(Object, String, Uri, AsyncCallback, Object)

Läser asynkront in en sida med relaterade entiteter från datatjänsten med hjälp av den angivna nästa länk-URI:n.
BeginSaveChanges(AsyncCallback, Object)

Skickar asynkront de väntande ändringarna till datatjänsten som samlats in av DataServiceContext sedan senaste gången ändringarna sparades.
BeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)

Skickar asynkront de väntande ändringarna till datatjänsten som samlats in av DataServiceContext sedan senaste gången ändringarna sparades.
CancelRequest(IAsyncResult)

Försöker avbryta åtgärden som är associerad med det angivna IAsyncResult objektet.
CreateQuery<T>(String)

Skapar en datatjänstfråga för data av en angiven allmän typ.
DeleteLink(Object, String, Object)

Ändrar status för länken till borttagen i listan över länkar som spåras av DataServiceContext.
DeleteObject(Object)

Ändrar tillståndet för det angivna objektet som ska tas bort i DataServiceContext.
Detach(Object)

Tar bort entiteten från listan över entiteter som DataServiceContext spårar.
DetachLink(Object, String, Object)

Tar bort den angivna länken från listan med länkar som spåras av DataServiceContext.
EndExecute<TElement>(IAsyncResult)

Anropad för att slutföra BeginExecute<TElement>(Uri, AsyncCallback, Object).
EndExecuteBatch(IAsyncResult)

Anropad för att slutföra BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[]).
EndGetReadStream(IAsyncResult)

Anropas för att slutföra den asynkrona åtgärden att hämta en binär egenskap som en ström.
EndLoadProperty(IAsyncResult)

Anropas för att slutföra åtgärden BeginLoadProperty(Object, String, AsyncCallback, Object) .
EndSaveChanges(IAsyncResult)

Anropas för att slutföra åtgärden BeginSaveChanges(AsyncCallback, Object) .
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
Execute<T>(DataServiceQueryContinuation<T>)

Skickar en begäran till datatjänsten för att hämta nästa sida med data i ett sidsidigt frågeresultat.
Execute<TElement>(Uri)

Skickar en begäran till datatjänsten om att köra en specifik URI.
ExecuteBatch(DataServiceRequest[])

Skickar en grupp frågor som en batch till datatjänsten.
GetEntityDescriptor(Object)

EntityDescriptor Hämtar för det angivna entitetsobjektet.
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetLinkDescriptor(Object, String, Object)

LinkDescriptor Hämtar för en specifik länk som definierar relationen mellan två entiteter.
GetMetadataUri()

Hämtar en URI för platsen för .edmx-metadata.
GetReadStream(Object, DataServiceRequestArgs)

Hämtar binära egenskapsdata för den angivna entiteten som en dataström tillsammans med de angivna meddelandehuvudena.
GetReadStream(Object, String)

Hämtar binära egenskapsdata för den angivna entiteten som en dataström, med angivet acceptmeddelandehuvud.
GetReadStream(Object)

Hämtar binära egenskapsdata för den angivna entiteten som en dataström.
GetReadStreamUri(Object)

Hämtar den URI som används för att returnera binära egenskapsdata som en dataström.
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
LoadProperty(Object, String, DataServiceQueryContinuation)

Läser in nästa sida med relaterade entiteter från datatjänsten med hjälp av det angivna frågefortsättningsobjektet.
LoadProperty(Object, String, Uri)

Läser in en sida med relaterade entiteter med hjälp av den angivna URI:n för nästa länk.
LoadProperty(Object, String)

Läser in uppskjutet innehåll för en angiven egenskap från datatjänsten.
LoadProperty<T>(Object, String, DataServiceQueryContinuation<T>)

Läser in nästa sida med relaterade entiteter från datatjänsten med hjälp av det angivna allmänna frågefortsättningsobjektet.
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
SaveChanges()

Sparar de ändringar som DataServiceContext spåras till lagring.
SaveChanges(SaveChangesOptions)

Sparar de ändringar som DataServiceContext spåras till lagring.
SetLink(Object, String, Object)

Meddelar DataServiceContext att det finns en ny länk mellan de angivna objekten och att länken representeras av egenskapen som anges av parametern sourceProperty .
SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)

Anger en ny dataström som binär egenskap för en entitet med de angivna inställningarna i begärandemeddelandet.
SetSaveStream(Object, Stream, Boolean, String, String)

Anger en ny dataström som binär egenskap för en entitet. De angivna rubrikerna innehållstyp och snigel ingår i begärandemeddelandet.
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)
TryGetEntity<TEntity>(Uri, TEntity)

Testa hämtningen av en entitet som spåras av DataServiceContext med referens till entitetens URI.
TryGetUri(Object, Uri)

Hämtar den kanoniska URI som är associerad med den angivna entiteten, om den är tillgänglig.
UpdateObject(Object)

Ändrar tillståndet för det angivna objektet i DataServiceContext till Modified.

Händelser

Name Description
ReadingEntity

Inträffar när entitetsdata har lästs in helt i entitetsobjektet.
SendingRequest

Inträffar när en ny HttpWebRequest har skapats.
WritingEntity

Inträffar när en entitet har serialiserats helt till XML i ett begärandemeddelande.

Gäller för

Se även