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 pomocí DataServiceContext nástroje Add Service Reference tool implicitně spustit dotaz na datovou službu Northwind, která vrací všechny zákazníky. Identifikátor URI požadované Customers sady entit je určen automaticky kontextem. Dotaz se spustí implicitně, když dojde k výčtu. Datová služba Northwind se vytvoří po dokončení služby 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

Datové služby WCF jsou bezstavové, ale DataServiceContext nejsou. Stav klienta se udržuje mezi interakcemi, 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

Name	Description
DataServiceContext(Uri)	Inicializuje novou instanci DataServiceContext třídy se zadaným serviceRoot.

Vlastnosti

Name	Description
ApplyingChanges	Získá hodnotu, která označuje, zda DataServiceContext je aktuálně aplikován 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é jsou používány každým dotazem vytvořeným pomocí objektu DataServiceContext .
DataNamespace	Získá nebo nastaví obor názvů XML pro datové položky, nikoli položky metadat, datové části Atom.
Entities	Získá seznam všech prostředků, které jsou aktuálně sledovány DataServiceContextnástrojem .
IgnoreMissingProperties	Získá nebo nastaví, zda vlastnosti přečtené z typu musí být mapovány na vlastnosti na straně klienta.
IgnoreResourceNotFoundException	Získá nebo nastaví, zda je vyvolána výjimka při 404 chyba (prostředek nenalezena) je vrácena datovou službou.
Links	Získá kolekci všech přidružení nebo odkazů, 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 k přepsání výchozí strategie překladu typu používané 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í možnosti překladu typu, která je používána klientskou knihovnou při přijímání entit z datové služby.
SaveChangesDefaultOptions	Získá nebo nastaví SaveChangesOptions hodnoty používané metodou SaveChanges() .
Timeout	Získá nebo nastaví možnost časového limitu, která se používá pro podkladový požadavek HTTP datové služby.
TypeScheme	Získá nebo nastaví identifikátor URI použitý k označení typu schématu, které služba používá.
UsePostTunneling	Získá nebo nastaví logickou hodnotu, která označuje, zda se má použít po tunelování.

Metody

Name	Description
AddLink(Object, String, Object)	Přidá zadaný odkaz na sadu objektů, které sleduje DataServiceContext .
AddObject(String, Object)	Přidá zadaný objekt do sady objektů, které sleduje DataServiceContext .
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í na DataServiceContext zahájení sledování zadaného propojení, které definuje vztah mezi objekty entity.
AttachTo(String, Object, String)	DataServiceContext Upozorní, aby zahájil sledování zadaného zdroje a poskytuje umístění prostředku v zadané sadě prostředků.
AttachTo(String, Object)	DataServiceContext Upozorní, aby začal sledovat zadaný zdroj a poskytuje umístění prostředku v zadané sadě prostředků.
BeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)	Asynchronně odešle požadavek datové službě, která načte další stránku dat ve výsledku stránkovaného dotazu.
BeginExecute<TElement>(Uri, AsyncCallback, Object)	Asynchronně odešle požadavek tak, aby toto volání neblokoval zpracování při čekání na výsledky ze služby.
BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[])	Asynchronně odešle do datové služby skupinu dotazů jako dávku.
BeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object)	Asynchronně získá data binární vlastnosti pro zadanou entitu jako datový proud 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í zadaného dalšího identifikátoru URI propojení.
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 přidruženou 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, který se odstraní v seznamu odkazů sledovaných uživatelem 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 sleduje.
DetachLink(Object, String, Object)	Odebere zadaný odkaz ze seznamu odkazů, DataServiceContextkteré sleduje .
EndExecute<TElement>(IAsyncResult)	Volá se k dokončení .BeginExecute<TElement>(Uri, AsyncCallback, Object)
EndExecuteBatch(IAsyncResult)	Volá se k dokončení .BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[])
EndGetReadStream(IAsyncResult)	Volá se k dokončení asynchronní operace načtení binární vlastnosti jako datového proudu.
EndLoadProperty(IAsyncResult)	Volá se k BeginLoadProperty(Object, String, AsyncCallback, Object) dokončení operace.
EndSaveChanges(IAsyncResult)	Volá se k BeginSaveChanges(AsyncCallback, Object) dokončení operace.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
Execute<T>(DataServiceQueryContinuation<T>)	Odešle žádost datové službě, která načte další stránku dat ve výsledku stránkovaného dotazu.
Execute<TElement>(Uri)	Odešle žádost datové službě, aby spustila konkrétní identifikátor URI.
ExecuteBatch(DataServiceRequest[])	Odešle skupinu dotazů jako dávku do datové služby.
GetEntityDescriptor(Object)	EntityDescriptor Získá pro zadaný objekt entity.
GetHashCode()	Slouží jako výchozí funkce hash. (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, DataServiceRequestArgs)	Získá data binární vlastnosti 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 zadaným záhlavím přijmout zprávu.
GetReadStream(Object)	Získá data binární vlastnosti pro zadanou entitu jako datový proud.
GetReadStreamUri(Object)	Získá identifikátor URI, který se používá k vrácení dat binární vlastnosti jako datového proudu.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
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 identifikátoru URI dalšího odkazu.
LoadProperty(Object, String)	Načte odložený obsah pro zadanou vlastnost z datové služby.
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 Object. (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)	DataServiceContext Upozorní, že mezi zadanými objekty existuje nové propojení a že propojení je reprezentováno vlastností určenou parametremsourceProperty.
SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)	Nastaví nový datový proud jako binární vlastnost entity se zadanými nastaveními ve zprávě požadavku.
SetSaveStream(Object, Stream, Boolean, String, String)	Nastaví nový datový proud 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)	Otestování načtení entity, kterou sleduje DataServiceContext odkaz 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 DataServiceContext na Modified.

Událost

Name	Description
ReadingEntity	Nastane po úplném načtení dat entity do objektu entity.
SendingRequest	Nastane, když se vytvoří nový HttpWebRequest .
WritingEntity	Nastane poté, co je entita plně serializována do XML ve zprávě požadavku.

Viz také

• Working with .NET Framework Client Libraries (WCF Data Services)