DataServiceContext Klasa

Definicja

Przestrzeń nazw:

System.Data.Services.Client

Zestaw:

System.Data.Services.Client.dll

Element DataServiceContext reprezentuje kontekst środowiska uruchomieniowego usługi danych.

public ref class DataServiceContext

public class DataServiceContext

type DataServiceContext = class

Public Class DataServiceContext

Dziedziczenie

Object

DataServiceContext

Przykłady

W poniższym przykładzie pokazano, jak używać wygenerowanego DataServiceContext przez narzędzie Add Service Reference tool w celu niejawnego wykonania zapytania względem usługi danych Northwind zwracającej wszystkich klientów. Identyfikator URI żądanego Customers zestawu jednostek jest określany automatycznie przez kontekst. Zapytanie jest wykonywane niejawnie po wystąpieniu wyliczenia. Usługa danych Northwind jest tworzona po zakończeniu Usługi danych programu WCF .

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

Uwagi

Usługi danych programu WCF są bezstanowe, ale DataServiceContext nie jest. Stan na kliencie jest utrzymywany między interakcjami w celu obsługi funkcji, takich jak zarządzanie aktualizacjami. Ta klasa i DataServiceQuery klasa reprezentująca określone żądanie HTTP do usługi danych to dwie główne klasy w bibliotece klienta.

Konstruktory

DataServiceContext(Uri)

Inicjuje DataServiceContext nowe wystąpienie klasy o określonej wartości serviceRoot.

Właściwości

ApplyingChanges	Pobiera wartość wskazującą, czy DataServiceContext aktualnie stosuje zmiany do śledzonych obiektów.
BaseUri	Pobiera bezwzględny identyfikator URI identyfikujący katalog główny usługi danych docelowych.
Credentials	Pobiera lub ustawia informacje uwierzytelniania używane przez każde zapytanie utworzone przy użyciu DataServiceContext obiektu.
DataNamespace	Pobiera lub ustawia przestrzeń nazw XML dla elementów danych, a nie elementów metadanych ładunku Atom.
Entities	Pobiera listę wszystkich zasobów, które są obecnie śledzone przez DataServiceContextprogram .
IgnoreMissingProperties	Pobiera lub ustawia, czy właściwości odczytane z typu muszą być mapowane na właściwości typu po stronie klienta.
IgnoreResourceNotFoundException	Pobiera lub ustawia, czy wyjątek jest zgłaszany, gdy zostanie zwrócony błąd 404 (nie znaleziono zasobu) przez usługę danych.
Links	Pobiera kolekcję wszystkich skojarzeń lub łączy, które są obecnie śledzone przez DataServiceContext obiekt.
MergeOption	Pobiera lub ustawia opcję synchronizacji dla odbierania jednostek z usługi danych.
ResolveName	Pobiera lub ustawia funkcję, aby zastąpić domyślną strategię rozpoznawania typów używaną przez bibliotekę klienta podczas wysyłania jednostek do usługi danych.
ResolveType	Pobiera lub ustawia funkcję używaną do zastępowania domyślnej opcji rozpoznawania typów używanej przez bibliotekę klienta podczas odbierania jednostek z usługi danych.
SaveChangesDefaultOptions	Pobiera lub ustawia SaveChangesOptions wartości, które są używane przez metodę SaveChanges() .
Timeout	Pobiera lub ustawia opcję limitu czasu używaną dla bazowego żądania HTTP do usługi danych.
TypeScheme	Pobiera lub ustawia identyfikator URI używany do wskazywania schematu typów używanego przez usługę.
UsePostTunneling	Pobiera lub ustawia wartość logiczną wskazującą, czy używać tunelowania po tunelowaniu.

Metody

AddLink(Object, String, Object)	Dodaje określony link do zestawu obiektów, które DataServiceContext śledzi.
AddObject(String, Object)	Dodaje określony obiekt do zestawu obiektów, które DataServiceContext śledzą.
AddRelatedObject(Object, String, Object)	Dodaje powiązany obiekt do kontekstu i tworzy łącze definiujące relację między dwoma obiektami w jednym żądaniu.
AttachLink(Object, String, Object)	Powiadamia element , DataServiceContext aby rozpocząć śledzenie określonego linku, który definiuje relację między obiektami jednostki.
AttachTo(String, Object)	Powiadamia użytkownika o DataServiceContext rozpoczęciu śledzenia określonego zasobu i dostarcza lokalizację zasobu w określonym zestawie zasobów.
AttachTo(String, Object, String)	Powiadamia element o DataServiceContext rozpoczęciu śledzenia określonego zasobu i dostarcza lokalizację zasobu w określonym zestawie zasobów.
BeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)	Asynchronicznie wysyła żądanie do usługi danych w celu pobrania następnej strony danych w wyniku zapytania stronicowanego.
BeginExecute<TElement>(Uri, AsyncCallback, Object)	Asynchronicznie wysyła żądanie, aby to wywołanie nie blokowało przetwarzania podczas oczekiwania na wyniki z usługi.
BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[])	Asynchronicznie przesyła grupę zapytań jako partię do usługi danych.
BeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object)	Asynchronicznie pobiera dane właściwości binarnych dla określonej jednostki jako strumienia danych wraz z określonymi nagłówkami komunikatów.
BeginLoadProperty(Object, String, AsyncCallback, Object)	Asynchronicznie ładuje wartość określonej właściwości z usługi danych.
BeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object)	Asynchronicznie ładuje następną stronę powiązanych jednostek z usługi danych przy użyciu dostarczonego obiektu kontynuacji zapytania.
BeginLoadProperty(Object, String, Uri, AsyncCallback, Object)	Asynchronicznie ładuje stronę powiązanych jednostek z usługi danych przy użyciu podanego następnego identyfikatora URI linku.
BeginSaveChanges(AsyncCallback, Object)	Asynchronicznie przesyła oczekujące zmiany do usługi danych zebranej przez DataServiceContext usługę od czasu ostatniego zapisania zmian.
BeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)	Asynchronicznie przesyła oczekujące zmiany do usługi danych zebranej przez DataServiceContext usługę od czasu ostatniego zapisania zmian.
CancelRequest(IAsyncResult)	Próbuje anulować operację skojarzona z podanym IAsyncResult obiektem.
CreateQuery<T>(String)	Tworzy zapytanie usługi danych dla danych określonego typu ogólnego.
DeleteLink(Object, String, Object)	Zmienia stan linku do usunięcia na liście linków śledzonych przez DataServiceContextelement .
DeleteObject(Object)	Zmienia stan określonego obiektu, który ma zostać usunięty w obiekcie DataServiceContext.
Detach(Object)	Usuwa jednostkę z listy jednostek, które śledzą DataServiceContext .
DetachLink(Object, String, Object)	Usuwa określony link z listy linków śledzonych przez DataServiceContextelement .
EndExecute<TElement>(IAsyncResult)	Wywołana w celu ukończenia operacji BeginExecute<TElement>(Uri, AsyncCallback, Object).
EndExecuteBatch(IAsyncResult)	Wywołana w celu ukończenia operacji BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[]).
EndGetReadStream(IAsyncResult)	Wywoływana w celu ukończenia asynchronicznej operacji pobierania właściwości binarnej jako strumienia.
EndLoadProperty(IAsyncResult)	Wywołana w celu ukończenia BeginLoadProperty(Object, String, AsyncCallback, Object) operacji.
EndSaveChanges(IAsyncResult)	Wywołana w celu ukończenia BeginSaveChanges(AsyncCallback, Object) operacji.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
Execute<T>(DataServiceQueryContinuation<T>)	Wysyła żądanie do usługi danych, aby pobrać następną stronę danych w wyniku zapytania stronicowanego.
Execute<TElement>(Uri)	Wysyła żądanie do usługi danych w celu wykonania określonego identyfikatora URI.
ExecuteBatch(DataServiceRequest[])	Przesyła grupę zapytań jako partię do usługi danych.
GetEntityDescriptor(Object)	Pobiera element EntityDescriptor dla dostarczonego obiektu jednostki.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLinkDescriptor(Object, String, Object)	LinkDescriptor Pobiera element dla określonego linku definiującego relację między dwiema jednostkami.
GetMetadataUri()	Pobiera identyfikator URI lokalizacji metadanych edmx.
GetReadStream(Object)	Pobiera dane właściwości binarnych dla określonej jednostki jako strumienia danych.
GetReadStream(Object, DataServiceRequestArgs)	Pobiera dane właściwości binarnej dla określonej jednostki jako strumienia danych wraz z określonymi nagłówkami komunikatów.
GetReadStream(Object, String)	Pobiera dane właściwości binarnej dla określonej jednostki jako strumienia danych z określonym nagłówkiem komunikatu Accept.
GetReadStreamUri(Object)	Pobiera identyfikator URI używany do zwracania danych właściwości binarnych jako strumienia danych.
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
LoadProperty(Object, String)	Ładuje odroczonej zawartości dla określonej właściwości z usługi danych.
LoadProperty(Object, String, DataServiceQueryContinuation)	Ładuje następną stronę powiązanych jednostek z usługi danych przy użyciu dostarczonego obiektu kontynuacji zapytania.
LoadProperty(Object, String, Uri)	Ładuje stronę powiązanych jednostek przy użyciu podanego następnego identyfikatora URI linku.
LoadProperty<T>(Object, String, DataServiceQueryContinuation<T>)	Ładuje następną stronę powiązanych jednostek z usługi danych przy użyciu dostarczonego ogólnego obiektu kontynuacji zapytania.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
SaveChanges()	Zapisuje zmiany, które DataServiceContext śledzą w magazynie.
SaveChanges(SaveChangesOptions)	Zapisuje zmiany, które DataServiceContext śledzą w magazynie.
SetLink(Object, String, Object)	Powiadamia o DataServiceContext tym, że istnieje nowe łącze między określonymi obiektami i że łącze jest reprezentowane przez właściwość określoną przez sourceProperty parametr .
SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)	Ustawia nowy strumień danych jako właściwość binarną jednostki z określonymi ustawieniami w komunikacie żądania.
SetSaveStream(Object, Stream, Boolean, String, String)	Ustawia nowy strumień danych jako właściwość binarną jednostki. Określone nagłówki Content-Type i Slug są uwzględniane w komunikacie żądania.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
TryGetEntity<TEntity>(Uri, TEntity)	Przetestuj pobieranie jednostki śledzonej przez DataServiceContext odwołanie do identyfikatora URI jednostki.
TryGetUri(Object, Uri)	Pobiera kanoniczny identyfikator URI skojarzony z określoną jednostką, jeśli jest dostępny.
UpdateObject(Object)	Zmienia stan określonego obiektu na DataServiceContextModified.

Zdarzenia

ReadingEntity	Występuje po całkowitym odczytaniu danych jednostki do obiektu jednostki.
SendingRequest	Występuje po utworzeniu nowego HttpWebRequest .
WritingEntity	Występuje po tym, jak jednostka została w pełni serializowana w formacie XML w komunikacie żądania.

Zobacz też

• Praca z bibliotekami klienta .NET Framework (Usługi danych programu WCF)