Partager via

Classe DataServiceContext

  • Article

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

Hiérarchie d'héritage

System.Object
  System.Data.Services.Client.DataServiceContext

Espace de noms :  System.Data.Services.Client
Assembly :  Microsoft.Data.Services.Client (en Microsoft.Data.Services.Client.dll)

Syntaxe

'Déclaration
Public Class DataServiceContext
'Utilisation
Dim instance As DataServiceContext

public class DataServiceContext

public ref class DataServiceContext

type DataServiceContext =  class end

public class DataServiceContext

Le type DataServiceContext expose les membres suivants.

Constructeurs

  Nom Description
Méthode publique DataServiceContext() Initialise une nouvelle instance de la classe DataServiceContext.
Méthode publique DataServiceContext(Uri) Initialise une nouvelle instance de la classe DataServiceContext avec le serviceRoot spécifié.
Méthode publique DataServiceContext(Uri, DataServiceProtocolVersion) Initialise une nouvelle instance de la classe DataServiceContext avec le serviceRoot spécifié et ciblant le maxProtocolVersion spécifique.

Haut de la page

Propriétés

  Nom Description
Propriété publique AddAndUpdateResponsePreference Obtient ou définit si le client demande que le service de données retourne les données d'entité dans le message de réponse à une requête de modification.
Propriété publique ApplyingChanges Obtient une valeur qui indique si le DataServiceContext applique actuellement des modifications aux objets suivis.
Propriété publique BaseUri Obtient l'URI absolu identifiant la racine du service de données cible.
Propriété publique Credentials Obtient ou définit les informations d'authentification utilisées par chaque requête créée à l'aide de l'objet DataServiceContext.
Propriété publique 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.
Propriété publique Entities Obtient une liste de toutes les ressources actuellement suivies par DataServiceContext.
Propriété publique HttpStack Obtient une valeur qui indique le type d'implémentation HTTP à utiliser lors de l'accès au service de données.Pris en charge uniquement par le cliente WCF Data Services 5.0 pour Silverlight.
Propriété publique 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.
Propriété publique 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.
Propriété publique Links Obtient la collection de l'ensemble des associations ou liens actuellement suivis par l'objet DataServiceContext.
Propriété publique MaxProtocolVersion Obtient la version maximale d'Protocole OData (Open Data) que le client est autorisé à utiliser.
Propriété publique MergeOption Obtient ou définit l'option de synchronisation pour recevoir des entités d'un service de données.
Propriété publique ResolveEntitySet Obtient ou définit la méthode déléguée utilisée pour résoudre l'URI du jeu d'entités lorsque la valeur ne peut pas être déterminée depuis un URI de lien Edit ou de lien Self.
Propriété publique 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.
Propriété publique 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.
Propriété publique SaveChangesDefaultOptions Obtient ou définit les valeurs SaveChangesOptions utilisées par la méthode SaveChanges.
Propriété publique Timeout Obtient ou définit l'option de délai (en secondes) qui est utilisée pour la requête HTTP sous-jacente au service de données.
Propriété publique TypeScheme Obtient ou définit l'URI utilisé pour indiquer le schéma de type utilisé par le service.
Propriété publique UseDefaultCredentials Obtient ou définit si les informations d'identification par défaut sont utilisées pour authentifier les requêtes au service de données. Pris en charge uniquement par le cliente WCF Data Services 5.0 pour Silverlight.
Propriété publique UsePostTunneling Obtient ou définit une valeur booléenne qui indique si le tunneling de publication doit être utilisé.

Haut de la page

Méthodes

  Nom Description
Méthode publique AddLink Ajoute le lien spécifié à l'ensemble d'objets suivi par DataServiceContext.
Méthode publique AddObject Ajoute l'objet spécifié à l'ensemble d'objets suivis par DataServiceContext.
Méthode publique AddRelatedObject 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.
Méthode publique AttachLink Informe le DataServiceContext qu'il doit commencer à suivre le lien spécifié qui définit une relation entre les objets d'entité.
Méthode publique 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é.
Méthode publique 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é.
Méthode publique BeginExecute(Uri, AsyncCallback, Object, String, array<OperationParameter[]) Envoie de façon asynchrone une requête au service de données pour exécuter l'URI spécifique.
Méthode publique 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.
Méthode publique 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é.
Méthode publique BeginExecute<TElement>(Uri, AsyncCallback, Object, String, Boolean, array<OperationParameter[]) Envoie de façon asynchrone une requête au service de données pour exécuter l'URI spécifique.
Méthode publique BeginExecuteBatch Soumet de façon asynchrone un groupe de requêtes au service de données sous forme de lot.
Méthode publique BeginGetReadStream(Object, DataServiceRequestArgs, AsyncCallback, Object) Obtient de façon asynchrone le flux de données binaires qui appartient à l'entité spécifiée, à l'aide des en-têtes de messages spécifiés.
Méthode publique BeginGetReadStream(Object, String, DataServiceRequestArgs, AsyncCallback, Object) Obtient de façon asynchrone un flux de données binaires nommé qui appartient à l'entité spécifiée, à l'aide des en-têtes de messages spécifiés.
Méthode publique BeginLoadProperty(Object, String, AsyncCallback, Object) Charge de façon asynchrone la valeur de la propriété spécifiée du service de données.
Méthode publique 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.
Méthode publique 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.
Méthode publique 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.
Méthode publique 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.
Méthode publique CancelRequest Tente d'annuler l'opération qui est associée à l'objet IAsyncResult fourni.
Méthode publique CreateQuery<T> Crée une requête de service de données pour les données d'un type générique spécifié.
Méthode publique DeleteLink Remplace l'état du lien par supprimé dans la liste des liens suivis par le DataServiceContext.
Méthode publique DeleteObject Remplace l'état de l'objet spécifié à supprimer dans le DataServiceContext.
Méthode publique Detach Supprime l'entité de la liste d'entités en cours de suivi par le DataServiceContext.
Méthode publique DetachLink Supprime le lien spécifié de la liste de liens en cours de suivi par le DataServiceContext.
Méthode publique EndExecute(IAsyncResult) Appelé pour terminer la méthode BeginExecute.
Méthode publique EndExecute<TElement>(IAsyncResult) Appelé pour terminer la méthode BeginExecute.
Méthode publique EndExecuteBatch Appelé pour terminer la méthode BeginExecuteBatch.
Méthode publique EndGetReadStream Appelé pour terminer l'opération asynchrone de récupération d'un flux de données binaires.
Méthode publique EndLoadProperty Appelé pour terminer l'opération BeginLoadProperty.
Méthode publique EndSaveChanges Appelé pour terminer l'opération BeginSaveChanges.
Méthode publique Equals (hérité de Object.)
Méthode publique Execute(Uri, String, array<OperationParameter[]) Envoie une requête au service de données pour exécuter l'URI spécifique à l'aide d'une méthode HTTP spécifique.N'est pas pris en charge par le cliente WCF Data Services 5.0 pour Silverlight.
Méthode publique Execute<TElement>(Uri) Envoie une requête au service de données pour exécuter l'URI spécifique.N'est pas pris en charge par le cliente WCF Data Services 5.0 pour Silverlight.
Méthode publique 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é.N'est pas pris en charge par le cliente WCF Data Services 5.0 pour Silverlight.
Méthode publique Execute<TElement>(Uri, String, Boolean, array<OperationParameter[]) Envoie une requête au service de données pour exécuter l'URI spécifique à l'aide d'une méthode HTTP spécifique.N'est pas pris en charge par le cliente WCF Data Services 5.0 pour Silverlight.
Méthode publique ExecuteBatch Soumet de façon synchrone un groupe de requêtes au service de données sous forme de lot.N'est pas pris en charge par le cliente WCF Data Services 5.0 pour Silverlight.
Méthode protégée Finalize (hérité de Object.)
Méthode publique GetEntityDescriptor Obtient le EntityDescriptor pour l'objet d'entité fourni.
Méthode publique GetHashCode (hérité de Object.)
Méthode publique GetLinkDescriptor Obtient le LinkDescriptor pour un lien spécifique qui définit la relation entre deux entités.
Méthode publique GetMetadataUri Obtient l'URI de l'emplacement des métadonnées .edmx.
Méthode publique GetReadStream(Object) Obtient le flux de données binaires qui appartient à l'entité spécifiée.N'est pas pris en charge par le cliente WCF Data Services 5.0 pour Silverlight.
Méthode publique GetReadStream(Object, DataServiceRequestArgs) Obtient le flux de données binaires pour l'entité spécifiée à l'aide des en-têtes de message spécifiés.N'est pas pris en charge par le cliente WCF Data Services 5.0 pour Silverlight.
Méthode publique GetReadStream(Object, String) Obtient le flux de données binaires qui appartient à l'entité spécifiée, à l'aide de l'en-tête de message Content-Type spécifié.N'est pas pris en charge par le cliente WCF Data Services 5.0 pour Silverlight.
Méthode publique GetReadStream(Object, String, DataServiceRequestArgs) Obtient un flux de données binaires nommé qui appartient à l'entité spécifiée, à l'aide de l'en-tête de message Content-Type spécifié.N'est pas pris en charge par le cliente WCF Data Services 5.0 pour Silverlight.
Méthode publique GetReadStreamUri(Object) Obtient l'URI qui est utilisé pour retourner un flux de données binaires.
Méthode publique GetReadStreamUri(Object, String) Obtient l'URI qui est utilisé pour retourner un flux de données binaires nommé.
Méthode publique GetType (hérité de Object.)
Méthode publique LoadProperty(Object, String) Charge le contenu différé pour une propriété spécifiée du service de données.N'est pas pris en charge par le cliente WCF Data Services 5.0 pour Silverlight.
Méthode publique 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.N'est pas pris en charge par le cliente WCF Data Services 5.0 pour Silverlight.
Méthode publique LoadProperty(Object, String, Uri) Charge une page d'entités associées à l'aide de l'URI de lien suivant fourni.N'est pas pris en charge par le cliente WCF Data Services 5.0 pour Silverlight.
Méthode publique 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.N'est pas pris en charge par le cliente WCF Data Services 5.0 pour Silverlight.
Méthode protégée MemberwiseClone (hérité de Object.)
Méthode publique SaveChanges() Enregistre les modifications que le DataServiceContext suit jusqu'au stockage.N'est pas pris en charge par le cliente WCF Data Services 5.0 pour Silverlight.
Méthode publique SaveChanges(SaveChangesOptions) Enregistre les modifications que le DataServiceContext suit jusqu'au stockage.N'est pas pris en charge par le cliente WCF Data Services 5.0 pour Silverlight.
Méthode publique SetLink 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.
Méthode publique SetSaveStream(Object, Stream, Boolean, DataServiceRequestArgs) Définit un flux de données binaires pour l'entité spécifiée, avec les en-têtes spécifiés dans le message de requête.
Méthode publique SetSaveStream(Object, Stream, Boolean, String, String) Définit un flux de données binaires qui appartient à l'entité spécifiée, avec les en-têtes Content-Type et Slug spécifiés dans le message de requête.
Méthode publique SetSaveStream(Object, String, Stream, Boolean, DataServiceRequestArgs) Définit un flux de données binaires nommé qui appartient à l'entité spécifiée, avec les en-têtes spécifiés dans le message de requête.
Méthode publique SetSaveStream(Object, String, Stream, Boolean, String) Définit un flux de données binaires pour l'entité spécifiée.
Méthode publique ToString (hérité de Object.)
Méthode publique TryGetEntity<TEntity> Récupération test d'une entité suivie par le DataServiceContext par référence à l'URI de l'entité.
Méthode publique TryGetUri Récupère l'URI canonique associé à l'entité spécifiée, s'il est disponible.
Méthode publique UpdateObject Remplace l'état de l'objet spécifié dans le DataServiceContext par Modified.

Haut de la page

Événements

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

Haut de la page

Notes

Services de données WCF sont sans état, mais ce n'est pas le cas de DataServiceContext. 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.

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 réalisez le démarrage rapide de Services de données WCF.

' 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

// 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);
}

Sécurité des threads

Tous les membres publics static (Shared dans Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.

Voir aussi

Référence

Espace de noms System.Data.Services.Client

Autres ressources

Client de données (WCF Data Services)