DataServiceContext Classe

Définition

Espace de noms:

System.Data.Services.Client

Assembly:

System.Data.Services.Client.dll

DataServiceContext représente le contexte du runtime du service de données.

public ref class DataServiceContext

public class DataServiceContext

type DataServiceContext = class

Public Class DataServiceContext

Héritage

Object

DataServiceContext

Exemples

L'exemple suivant montre comment utiliser le DataServiceContext généré par l'outil Ajouter une référence de service pour exécuter implicitement une requête sur le service de données Northwind qui retourne tous les clients. L'URI du jeu d'entités Customers demandé est déterminé automatiquement par le contexte. La requête est exécutée implicitement lorsque l'énumération se produit. Le service de données Northwind est créé lorsque vous terminez l’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

Remarques

WCF Data Services sont sans état, mais ce n’est pas le DataServiceContext cas. L’état sur le client est mis à jour entre les interactions pour prendre en charge les fonctionnalités telles que la gestion des mises à jour. Cette classe et la classe DataServiceQuery, qui représente une requête HTTP particulière pour un service de données, sont les deux classes principales dans la bibliothèque cliente.

Constructeurs

DataServiceContext(Uri)

Initialise une nouvelle instance de la classe DataServiceContext avec le serviceRoot spécifié.

Propriétés

ApplyingChanges	Obtient une valeur qui indique si le DataServiceContext applique actuellement des modifications aux objets suivis.
BaseUri	Obtient l'URI absolu identifiant la racine du service de données cible.
Credentials	Obtient ou définit les informations d'authentification utilisées par chaque requête créée à l'aide de l'objet DataServiceContext.
DataNamespace	Obtient ou définit l'espace de noms XML pour les éléments de données, et non les éléments de métadonnées, d'une charge utile Atom.
Entities	Obtient une liste de toutes les ressources actuellement suivies par DataServiceContext.
IgnoreMissingProperties	Obtient ou définit si les propriétés lues depuis le type doivent être mappées aux propriétés sur le type côté client.
IgnoreResourceNotFoundException	Obtient ou définit si une exception est levée lorsqu'une erreur 404 (ressource introuvable) est retournée par le service de données.
Links	Obtient la collection de l’ensemble des associations ou liens actuellement suivis par l’objet DataServiceContext.
MergeOption	Obtient ou définit l'option de synchronisation pour recevoir des entités d'un service de données.
ResolveName	Obtient ou définit une fonction pour substituer la stratégie de résolution de type par défaut utilisée par la bibliothèque cliente lorsque vous envoyez des entités à un service de données.
ResolveType	Obtient ou définit une fonction qui est utilisée pour remplacer l’option de résolution de type par défaut qui est utilisée par la bibliothèque cliente lors de la réception d’entités depuis un service de données.
SaveChangesDefaultOptions	Obtient ou définit les valeurs SaveChangesOptions utilisées par la méthode SaveChanges().
Timeout	Obtient ou définit l'option de délai d'attente qui est utilisée pour la requête HTTP sous-jacente au service de données.
TypeScheme	Obtient ou définit l'URI utilisé pour indiquer le schéma de type utilisé par le service.
UsePostTunneling	Obtient ou définit une valeur booléenne qui indique si le tunneling de publication doit être utilisé.

Méthodes

AddLink(Object, String, Object)	Ajoute le lien spécifié à l'ensemble d'objets suivi par DataServiceContext.
AddObject(String, Object)	Ajoute l'objet spécifié à l'ensemble d'objets suivis par DataServiceContext.
AddRelatedObject(Object, String, Object)	Ajoute un objet associé au contexte et crée le lien qui définit la relation entre les deux objets dans une requête unique.
AttachLink(Object, String, Object)	Informe le DataServiceContext qu'il doit commencer à suivre le lien spécifié qui définit une relation entre les objets d'entité.
AttachTo(String, Object)	Informe le DataServiceContext qu'il doit commencer à suivre la ressource spécifiée et fournit l'emplacement de la ressource dans le jeu de ressources spécifié.
AttachTo(String, Object, String)	Informe le DataServiceContext qu'il doit commencer à suivre la ressource spécifiée et fournit l'emplacement de la ressource dans le jeu de ressources spécifié.
BeginExecute<T>(DataServiceQueryContinuation<T>, AsyncCallback, Object)	Envoie de façon asynchrone une requête au service de données pour récupérer la page de données suivante dans un résultat de requête paginé.
BeginExecute<TElement>(Uri, AsyncCallback, Object)	Envoie de façon asynchrone la requête afin que cet appel ne bloque pas le traitement en attendant les résultats du service.
BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[])	Soumet de façon asynchrone un groupe de requêtes au service de données sous forme de lot.
BeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object)	Obtient, de manière asynchrone, les données de propriété binaires pour l'entité spécifiée sous la forme d'un flux de données, ainsi que les en-têtes de message spécifiés.
BeginLoadProperty(Object, String, AsyncCallback, Object)	Charge de façon asynchrone la valeur de la propriété spécifiée du service de données.
BeginLoadProperty(Object, String, DataServiceQueryContinuation, AsyncCallback, Object)	Charge de façon asynchrone la page d'entités associées suivante du service de données en utilisant l'objet de continuation de requête fourni.
BeginLoadProperty(Object, String, Uri, AsyncCallback, Object)	Charge de façon asynchrone une page d'entités associées à partir du service de données à l'aide de l'URI de lien suivant fourni.
BeginSaveChanges(AsyncCallback, Object)	Soumet de façon asynchrone au service de données les modifications en attente collectées par le DataServiceContext depuis le dernier enregistrement de ces modifications.
BeginSaveChanges(SaveChangesOptions, AsyncCallback, Object)	Soumet de façon asynchrone au service de données les modifications en attente collectées par le DataServiceContext depuis le dernier enregistrement de ces modifications.
CancelRequest(IAsyncResult)	Tente d'annuler l'opération qui est associée à l'objet IAsyncResult fourni.
CreateQuery<T>(String)	Crée une requête de service de données pour les données d'un type générique spécifié.
DeleteLink(Object, String, Object)	Remplace l'état du lien par Deleted dans la liste des liens suivis par le DataServiceContext.
DeleteObject(Object)	Remplace l'état de l'objet spécifié à supprimer dans le DataServiceContext.
Detach(Object)	Supprime l'entité de la liste d'entités en cours de suivi par le DataServiceContext.
DetachLink(Object, String, Object)	Supprime le lien spécifié de la liste de liens en cours de suivi par le DataServiceContext.
EndExecute<TElement>(IAsyncResult)	Appelé pour terminer la méthode BeginExecute<TElement>(Uri, AsyncCallback, Object).
EndExecuteBatch(IAsyncResult)	Appelé pour terminer la méthode BeginExecuteBatch(AsyncCallback, Object, DataServiceRequest[]).
EndGetReadStream(IAsyncResult)	Appelé pour terminer l'opération asynchrone de récupération d'une propriété binaire sous la forme d'un flux.
EndLoadProperty(IAsyncResult)	Appelé pour terminer l'opération BeginLoadProperty(Object, String, AsyncCallback, Object).
EndSaveChanges(IAsyncResult)	Appelé pour terminer l'opération BeginSaveChanges(AsyncCallback, Object).
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
Execute<T>(DataServiceQueryContinuation<T>)	Envoie une requête au service de données pour récupérer la page de données suivante dans un résultat de requête paginé.
Execute<TElement>(Uri)	Envoie une requête au service de données pour exécuter l'URI spécifique.
ExecuteBatch(DataServiceRequest[])	Soumet un groupe de requêtes au service de données sous forme de lot.
GetEntityDescriptor(Object)	Obtient le EntityDescriptor pour l'objet entité fourni.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetLinkDescriptor(Object, String, Object)	Obtient le LinkDescriptor pour un lien spécifique qui définit la relation entre deux entités.
GetMetadataUri()	Obtient l'URI de l'emplacement des métadonnées .edmx.
GetReadStream(Object)	Obtient des données de propriété binaires pour l'entité spécifiée sous la forme d'un flux de données.
GetReadStream(Object, DataServiceRequestArgs)	Obtient les données de propriété binaires pour l'entité spécifiée sous la forme d'un flux de données, ainsi que les en-têtes de message spécifiés.
GetReadStream(Object, String)	Obtient les données de propriété binaires pour l'entité spécifiée sous la forme d'un flux de données, avec l'en-tête de message Accept.
GetReadStreamUri(Object)	Obtient l'URI qui est utilisé pour retourner les données de propriété binaires sous la forme d'un flux de données.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
LoadProperty(Object, String)	Charge le contenu différé pour une propriété spécifiée du service de données.
LoadProperty(Object, String, DataServiceQueryContinuation)	Charge la page d'entités associées suivante du service de données en utilisant l'objet de continuation de requête fourni.
LoadProperty(Object, String, Uri)	Charge une page d'entités associées à l'aide de l'URI de lien suivant fourni.
LoadProperty<T>(Object, String, DataServiceQueryContinuation<T>)	Charge la page d'entités associées suivante du service de données en utilisant l'objet de continuation de requête générique fourni.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
SaveChanges()	Enregistre les modifications que le DataServiceContext suit jusqu'au stockage.
SaveChanges(SaveChangesOptions)	Enregistre les modifications que le DataServiceContext suit jusqu'au stockage.
SetLink(Object, String, Object)	Informe le DataServiceContext qu'un nouveau lien existe entre les objets spécifiés et que ce lien est représenté par la propriété spécifiée par le paramètre sourceProperty.
SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs)	Définit un nouveau flux de données comme propriété binaire d'une entité, avec les paramètres spécifiés dans le message de demande.
SetSaveStream(Object, Stream, Boolean, String, String)	Définit un nouveau flux de données comme propriété binaire d'une entité. Les en-têtes Content-type et Slug spécifié sont inclus dans le message de demande.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
TryGetEntity<TEntity>(Uri, TEntity)	Récupération test d'une entité suivie par le DataServiceContext par référence à l'URI de l'entité.
TryGetUri(Object, Uri)	Récupère l'URI canonique associé à l'entité spécifiée, s'il est disponible.
UpdateObject(Object)	Remplace l'état de l'objet spécifié dans le DataServiceContext par Modified.

Événements

ReadingEntity	Se produit lorsque des données d'entité ont été entièrement lues dans l'objet entité.
SendingRequest	Se produit lorsqu'une HttpWebRequest a été créée.
WritingEntity	Se produit lorsqu'une entité a été entièrement sérialisée en XML dans un message de requête.

Voir aussi

• Utilisation des bibliothèques clientes .NET Framework (WCF Data Services)