RequestContext Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit une réponse mise en correspondance avec une demande entrante.
public ref class RequestContext abstract : IDisposable
public abstract class RequestContext : IDisposable
type RequestContext = class
interface IDisposable
Public MustInherit Class RequestContext
Implements IDisposable
- Héritage
-
RequestContext
- Implémente
Remarques
Vous obtenez un contexte de demande à partir d'un IReplyChannel. Chaque RequestContext encapsule les informations requises pour répondre à la demande. Vous ne devez dès lors pas bloquer le canal lorsque chaque message de demande attend une réponse.
Dans le modèle de demande/réponse, l’objet RequestContext est le lien entre la demande qui arrive et la réponse qui sort. Lorsque le serveur reçoit une demande, il fournit une RequestContext instance qui représente la demande au canal. Entre autres propriétés utiles, le contexte de demande contient le message de demande d'origine. Ce contexte de demande est ensuite dissimulé dans OperationContext pour pouvoir être récupéré par votre service. Vous utilisez en général la propriété Current pour accéder à la demande de l'opération actuelle.
RequestContext peut avoir la valeur null
. Étant donné que le rôle du contexte de demande est de lier des demandes à des réponses, il n'est pas utile d'avoir un contexte de demande s'il n'y a pas de réponse. Ainsi, dans ce cas, le contexte a la valeur null
. Pour une opération monodirectionnelle sur le modèle demande/réponse, le serveur reçoit des demandes, mais ne renvoie pas de réponse au client. Par conséquent, si RequestContext a la valeur null
alors qu'une autre valeur est attendue, vérifiez d'abord si le contrat d'opération est IsOneWay.
Remarque spéciale destinée aux utilisateurs C++ managés dérivés de cette classe :
Placez votre code de nettoyage dans (On)(Begin)Close (et/ou OnAbort), pas dans un destructeur.
Évitez les destructeurs car ils provoquent la génération automatique de IDisposable par le compilateur.
Évitez les membres sans référence car ils peuvent provoquer la génération automatique de IDisposable par le compilateur.
Évitez les finaliseurs ; si vous en incluez un, vous devrez supprimer l'avertissement de génération et appeler SuppressFinalize(Object) et le finaliseur proprement dit à partir de (On)(Begin)Close (et/ou OnAbort) pour émuler ce qui aurait été le comportement IDisposable généré automatiquement.
Constructeurs
RequestContext() |
Initialise une nouvelle instance de la classe RequestContext. |
Propriétés
RequestMessage |
En cas de substitution dans une classe dérivée, obtient le message qui contient la demande. |
Méthodes
Abort() |
En cas de substitution dans une classe dérivée, abandonne le traitement de la demande associée au contexte. |
BeginReply(Message, AsyncCallback, Object) |
En cas de substitution dans une classe dérivée, démarre une opération asynchrone pour répondre à la demande associée au contexte actuel. |
BeginReply(Message, TimeSpan, AsyncCallback, Object) |
En cas de substitution dans une classe dérivée, démarre une opération asynchrone pour répondre à la demande associée au contexte actuel dans un intervalle donné. |
Close() |
En cas de substitution dans une classe dérivée, ferme l'opération qui répond au contexte de demande associé au contexte actuel. |
Close(TimeSpan) |
En cas de substitution dans une classe dérivée, ferme l'opération qui répond au contexte de demande associé au contexte actuel dans un intervalle donné. |
Dispose(Boolean) |
Libère les ressources associées au contexte. |
EndReply(IAsyncResult) |
Lors d'une substitution dans une classe dérivée, termine une opération asynchrone pour répondre à un message de demande. |
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
Reply(Message) |
En cas de substitution dans une classe dérivée, répond à un message de demande. |
Reply(Message, TimeSpan) |
En cas de substitution dans une classe dérivée, répond à un message de demande dans un intervalle spécifié. |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
Implémentations d’interfaces explicites
IDisposable.Dispose() |
Libère les ressources managées et non managées associées au contexte. |