Freigeben über

HttpResponse.Filter Eigenschaft

Definition

Namespace:
System.Web
Assembly:
System.Web.dll

Dient zum Abrufen oder Festlegen eines Umbruchfilterobjekts, das zum Ändern des HTTP-Entitätstexts vor der Übertragung verwendet wird.

public:
 property System::IO::Stream ^ Filter { System::IO::Stream ^ get(); void set(System::IO::Stream ^ value); };
public System.IO.Stream Filter { get; set; }
member this.Filter : System.IO.Stream with get, set
Public Property Filter As Stream

Eigenschaftswert

Stream

Das Stream Objekt, das als Ausgabefilter fungiert.

Ausnahmen

HttpException

Filterung ist für die Entität nicht zulässig.

Beispiele

Das folgende Beispiel ist eine ASP.NET Seite, die die Filter Eigenschaft auf eine neue Instanz der UpperCaseFilter Klasse festlegt, eine benutzerdefinierte Stream Klasse, die den gesamten Text konvertiert, der sie in Großbuchstaben übergibt. Die Informationen zur Anforderung werden in einer Textdatei gespeichert, und dann wird die Filter Eigenschaft festgelegt. Nachdem der Antwortfilter vorhanden ist, ruft der Code die MapPath Methode auf, um den absoluten Pfad zu einer Textdatei TestFile.txt abzurufen, die als Quelle für den Inhalt der Antwort dient. Der Code erstellt dann ein neues StreamReader Objekt, um die Textdatei von Anfang bis Ende zu lesen, und ruft dann die Write Methode auf, um den Inhalt der Datei auf der Seite anzuzeigen.

<%@ 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>

<%@ Page Language="VB" Debug="true"%>
<%@ Import Namespace="System.IO" %>
<%@ Import Namespace="Samples.AspNet.VB.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 Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
      
    ' 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.
    Dim fullpath As String = Request.MapPath("~\\TestFile.txt")
    
    Try
      
      Dim sr As StreamReader = New StreamReader(fullpath)
      
      Do While sr.Peek() >= 0
        Response.Write(Convert.ToChar(sr.Read()))
      Loop
      sr.Close()
      Message.Text = "Reading the file was successful."
      
    Catch ex As Exception
      
      Message.Text = "The process failed."

    End Try

    
  End Sub

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

Hinweise

Wenn Sie ein Stream Objekt erstellen und die Filter Eigenschaft auf das Stream Objekt festlegen, werden alle http-Ausgaben, die durch Write den Filter gesendet werden, übergeben.

Gilt für: