Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. |
Traduction
Source
|
HttpResponse.Filter, propriété
Obtient ou définit un objet wrapping filter à utiliser pour modifier le corps d'une entité HTTP avant la transmission.
Assembly : System.Web (dans System.Web.dll)
| Exception | Condition |
|---|---|
| HttpException |
Le filtrage n'est pas autorisé avec cette entité. |
Lorsque vous créez un objet Stream et affectez comme valeur à la propriété Filter l'objet Stream, toutes les données de sortie HTTP envoyées par Write passent par le filtre.
L'exemple suivant consiste en une page ASP.NET qui affecte pour valeur à la propriété Filter une nouvelle instance de la classe UpperCaseFilter, une classe Stream personnalisée qui convertit en majuscules tout texte qui transite par son biais. Les informations sur la requête sont enregistrées dans un fichier texte, puis la propriété Filter est définie. Après la mise en place du filtre de réponse, le code appelle la méthode MapPath pour obtenir le chemin d'accès absolu à un fichier texte nommé TestFile.txt qui sert de source au contenu de la réponse. Le code crée alors un objet StreamReader pour lire le fichier texte du début à la fin, puis appelle la méthode Write pour afficher le contenu du fichier dans la page.
<%@ Page Language="C#" %> <%@ Import Namespace="System.IO" %> <%@ import Namespace="Samples.AspNet.CS.Controls" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <script runat="server"> private void Page_Load(object sender, EventArgs e) { // Filter the text to be rendered as all uppercase. Response.Filter = new UpperCaseFilterStream(Response.Filter); // Convert a virtual path to a fully qualified physical path. string fullpath = Request.MapPath("~\\TestFile.txt"); try { // Read the contents of the file using a StreamReader. using (StreamReader sr = new StreamReader(fullpath)) while (sr.Peek() >= 0) { Response.Write((char)sr.Read()); } Message.Text = "Reading the file was successful."; } catch (Exception ex) { Message.Text = "The process failed."; } } </script> <html xmlns="http://www.w3.org/1999/xhtml" > <head> <title>HttpResponse.MapPath Example</title> </head> <body> <form id="form1" runat="server"> <asp:Label id="Message" runat="server"/> </form> </body> </html>
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
