DataServiceContext Třída

Definice

Obor názvů:

System.Data.Services.Client

Sestavení:

System.Data.Services.Client.dll

Představuje DataServiceContext kontext modulu runtime datové služby.

public ref class DataServiceContext

public class DataServiceContext

type DataServiceContext = class

Public Class DataServiceContext

Dědičnost

Object

DataServiceContext

Příklady

Následující příklad ukazuje, jak použít DataServiceContext příkaz vygenerovaný nástrojem Přidat odkaz na službu k implicitnímu spuštění dotazu na datovou službu Northwind, která vrací všechny zákazníky. Identifikátor URI požadované Customers sady entit je automaticky určen kontextem. Dotaz se spustí implicitně při výskytu výčtu. Datová služba Northwind se vytvoří po dokončení 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

Poznámky

WCF Data Services jsou bezstavové, ale DataServiceContext není. Stav klienta se mezi interakcemi udržuje, aby bylo možné podporovat funkce, jako je správa aktualizací. Tato třída a DataServiceQuery třída, která představuje konkrétní požadavek HTTP na datovou službu, jsou dvě hlavní třídy v klientské knihovně.

Konstruktory

DataServiceContext(Uri)

Inicializuje novou instanci DataServiceContext třídy se zadaným serviceRootparametrem .

Vlastnosti

ApplyingChanges	Získá hodnotu, která označuje, zda DataServiceContext je aktuálně aplikovány změny na sledované objekty.
BaseUri	Získá absolutní identifikátor URI identifikující kořen cílové datové služby.
Credentials	Získá nebo nastaví ověřovací informace, které se používají v každém dotazu vytvořeném pomocí objektu DataServiceContext .
DataNamespace	Získá nebo nastaví obor názvů XML pro položky dat, nikoli položky metadat, datové části Atom.
Entities	Získá seznam všech prostředků aktuálně sledovaných objektem DataServiceContext.
IgnoreMissingProperties	Získá nebo nastaví, zda vlastnosti přečtené z typu musí být mapovány na vlastnosti na straně klienta typu.
IgnoreResourceNotFoundException	Získá nebo nastaví, zda je vyvolána výjimka při chybě 404 (prostředek nebyl nalezen) je vrácena datovou službou.
Links	Získá kolekci všech přidružení nebo propojení, které jsou aktuálně sledovány objektem DataServiceContext .
MergeOption	Získá nebo nastaví možnost synchronizace pro příjem entit z datové služby.
ResolveName	Získá nebo nastaví funkci, která přepíše výchozí strategii rozlišení typu používanou klientskou knihovnou při odesílání entit do datové služby.
ResolveType	Získá nebo nastaví funkci, která se používá k přepsání výchozí typ rozlišení možnost, která se používá v klientské knihovně při přijímání entit z datové služby.
SaveChangesDefaultOptions	Získá nebo nastaví SaveChangesOptions hodnoty, které jsou používány metodou SaveChanges() .
Timeout	Získá nebo nastaví možnost časového limitu, který se používá pro podkladový požadavek HTTP na datovou službu.
TypeScheme	Získá nebo nastaví identifikátor URI sloužící k označení, jaké schéma typu služba používá.
UsePostTunneling	Získá nebo nastaví logickou hodnotu, která označuje, zda použít po tunelování.

Metody

AddLink(Object, String, Object)	Přidá zadaný odkaz na sadu objektů, které DataServiceContext sleduje.
AddObject(String, Object)	Přidá zadaný objekt do sady objektů, které DataServiceContext sleduje.
AddRelatedObject(Object, String, Object)	Přidá související objekt do kontextu a vytvoří propojení, které definuje vztah mezi dvěma objekty v jednom požadavku.
AttachLink(Object, String, Object)	Upozorní objekt, DataServiceContext aby začal sledovat zadaný odkaz, který definuje vztah mezi objekty entity.
AttachTo(String, Object)	Upozorní , DataServiceContext aby začal sledovat zadaný prostředek, a poskytne umístění prostředku v rámci zadané sady prostředků.
AttachTo(String, Object, String)	Upozorní, DataServiceContext že má začít sledovat zadaný prostředek a poskytne umístění prostředku v zadané sadě prostředků.
BeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)	Asynchronně odešle do datové služby požadavek na načtení další stránky dat ve výsledku stránkovaného dotazu.
BeginExecute<TElement>(Uri, AsyncCallback, Object)	Asynchronně odesílá požadavek tak, aby toto volání neblokovala zpracování při čekání na výsledky ze služby.
BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[])	Asynchronně odešle skupinu dotazů jako dávku do datové služby.
BeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object)	Asynchronně získá data binární vlastnosti pro zadanou entitu jako datový stream spolu se zadanými hlavičkami zprávy.
BeginLoadProperty(Object, String, AsyncCallback, Object)	Asynchronně načte hodnotu zadané vlastnosti z datové služby.
BeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object)	Asynchronně načte další stránku souvisejících entit z datové služby pomocí zadaného objektu pokračování dotazu.
BeginLoadProperty(Object, String, Uri, AsyncCallback, Object)	Asynchronně načte stránku souvisejících entit z datové služby pomocí dalšího identifikátoru URI dalšího odkazu.
BeginSaveChanges(AsyncCallback, Object)	Asynchronně odešle čekající změny do datové služby shromážděné DataServiceContext od posledního uložení změn.
BeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)	Asynchronně odešle čekající změny do datové služby shromážděné DataServiceContext od posledního uložení změn.
CancelRequest(IAsyncResult)	Pokusí se zrušit operaci, která je přidružena k zadanému IAsyncResult objektu.
CreateQuery<T>(String)	Vytvoří dotaz datové služby pro data zadaného obecného typu.
DeleteLink(Object, String, Object)	Změní stav odkazu na odstraněný v seznamu odkazů sledovaných nástrojem DataServiceContext.
DeleteObject(Object)	Změní stav zadaného objektu, který má být odstraněn v objektu DataServiceContext.
Detach(Object)	Odebere entitu ze seznamu entit, které DataServiceContext objekt sleduje.
DetachLink(Object, String, Object)	Odebere zadaný odkaz ze seznamu odkazů sledovaných objektem DataServiceContext.
EndExecute<TElement>(IAsyncResult)	Volá se k dokončení příkazu BeginExecute<TElement>(Uri, AsyncCallback, Object).
EndExecuteBatch(IAsyncResult)	Volá se k dokončení příkazu BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[]).
EndGetReadStream(IAsyncResult)	Volána k dokončení asynchronní operace načtení binární vlastnosti jako datového proudu.
EndLoadProperty(IAsyncResult)	Volána k dokončení BeginLoadProperty(Object, String, AsyncCallback, Object) operace.
EndSaveChanges(IAsyncResult)	Volána k dokončení BeginSaveChanges(AsyncCallback, Object) operace.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
Execute<T>(DataServiceQueryContinuation<T>)	Odešle do datové služby požadavek na načtení další stránky dat ve výsledku stránkovaného dotazu.
Execute<TElement>(Uri)	Odešle žádost datové službě o provedení konkrétního identifikátoru URI.
ExecuteBatch(DataServiceRequest[])	Odešle skupinu dotazů jako dávku do datové služby.
GetEntityDescriptor(Object)	Získá pro EntityDescriptor zadaný objekt entity.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLinkDescriptor(Object, String, Object)	LinkDescriptor Získá pro konkrétní propojení, které definuje vztah mezi dvěma entitami.
GetMetadataUri()	Získá identifikátor URI umístění metadat .edmx.
GetReadStream(Object)	Získá binární data vlastností pro zadanou entitu jako datový proud.
GetReadStream(Object, DataServiceRequestArgs)	Získá binární vlastnosti data pro zadanou entitu jako datový proud spolu se zadanými hlavičkami zprávy.
GetReadStream(Object, String)	Získá data binární vlastnosti pro zadanou entitu jako datový proud se zadanou hlavičkou přijmout zprávu.
GetReadStreamUri(Object)	Získá identifikátor URI, který se používá k vrácení dat binární vlastnosti jako datový proud.
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
LoadProperty(Object, String)	Načte odložený obsah pro zadanou vlastnost z datové služby.
LoadProperty(Object, String, DataServiceQueryContinuation)	Načte další stránku souvisejících entit z datové služby pomocí zadaného objektu pokračování dotazu.
LoadProperty(Object, String, Uri)	Načte stránku souvisejících entit pomocí zadaného dalšího identifikátoru URI odkazu.
LoadProperty<T>(Object, String, DataServiceQueryContinuation<T>)	Načte další stránku souvisejících entit z datové služby pomocí zadaného objektu pokračování obecného dotazu.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
SaveChanges()	Uloží změny, které DataServiceContext sleduje, do úložiště.
SaveChanges(SaveChangesOptions)	Uloží změny, které DataServiceContext sleduje, do úložiště.
SetLink(Object, String, Object)	Upozorní objekt, DataServiceContext že mezi zadanými objekty existuje nové propojení a že propojení je reprezentováno vlastností určenou parametrem sourceProperty .
SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)	Nastaví nový datový stream jako binární vlastnost entity se zadaným nastavením ve zprávě požadavku.
SetSaveStream(Object, Stream, Boolean, String, String)	Nastaví nový datový stream jako binární vlastnost entity. Zadaná hlavička Content-Type a Slug jsou součástí zprávy požadavku.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TryGetEntity<TEntity>(Uri, TEntity)	Testovací načtení entity sledované objektem DataServiceContext pomocí odkazu na identifikátor URI entity.
TryGetUri(Object, Uri)	Načte kanonický identifikátor URI přidružený k zadané entitě, pokud je k dispozici.
UpdateObject(Object)	Změní stav zadaného objektu v objektu na DataServiceContextModified.

Událost

ReadingEntity	Vyvolá se po úplném načtení dat entity do objektu entity.
SendingRequest	Vyvolá se při vytvoření nového HttpWebRequest .
WritingEntity	Nastane po entitě byla plně serializována do XML ve zprávě požadavku.

Viz také

• Práce s klientskými knihovnami rozhraní .NET Framework (WCF Data Services)