Page.CreateHtmlTextWriter-Methode

Erstellt zum Rendern des Seiteninhalts ein HtmlTextWriter-Objekt.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Protected Friend Overridable Function CreateHtmlTextWriter ( _
    tw As TextWriter _
) As HtmlTextWriter
'Usage
Dim tw As TextWriter
Dim returnValue As HtmlTextWriter

returnValue = Me.CreateHtmlTextWriter(tw)

protected internal virtual HtmlTextWriter CreateHtmlTextWriter (
    TextWriter tw
)

protected public:
virtual HtmlTextWriter^ CreateHtmlTextWriter (
    TextWriter^ tw
)

protected HtmlTextWriter CreateHtmlTextWriter (
    TextWriter tw
)

protected internal function CreateHtmlTextWriter (
    tw : TextWriter
) : HtmlTextWriter

Parameter

• tw
  Der TextWriter zum Erstellen von HtmlTextWriter.

Rückgabewert

Ein HtmlTextWriter oder Html32TextWriter.

Hinweise

Die CreateHtmlTextWriter-Methode erstellt einen TextWriter über die Browser-Eigenschaft des Request-Objekts, das der Seitenanforderung zugeordnet ist. Sie können im browserCaps-Konfigurationsabschnitt einen Verweis auf einen HtmlTextWriter hinzufügen. Überschreiben Sie die CreateHtmlTextWriter-Methode, um benutzerdefinierte Suchläufe auszuführen.

Beispiel

Im folgenden Codebeispiel wird mit der CreateHtmlTextWriter-Methode eine Instanz eines benutzerdefinierten HtmlTextWriter-Objekts mit dem Namen MyHtmlTextWriter erstellt. Die CreateHtmlTextWriter-Methode wird in der von Page abgeleiteten MyPage-Klasse überschrieben, sodass MyHtmlTextWriter ASP.NET-Serversteuerelemente rendert, wenn die Seite angefordert wird. Beachten Sie, dass in diesem Beispiel TextWriter-Adapterverhalten verhindert wird.

Imports System
Imports System.IO
Imports System.Web.UI

Namespace WebPage

    
   Public Class MyPage
      Inherits Page
      
      Public Sub New()
         MyBase.New()
      End Sub 'New

      <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
      Protected Overrides Function CreateHtmlTextWriter(ByVal writer As TextWriter) As HtmlTextWriter
         Return New MyHtmlTextWriter(writer)
      End Function 'CreateHtmlTextWriter

      <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
      Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)
         ' Writes a Font control.
         writer.AddAttribute("color", "red")
         writer.AddAttribute("size", "6pt")
         writer.RenderBeginTag(HtmlTextWriterTag.Font)
         writer.Write(("<br>" + "The time on the server:<br> " + System.DateTime.Now.ToLongTimeString()))
         writer.RenderEndTag()
      End Sub 'Render
   End Class 'MyPage
    

   Public Class MyHtmlTextWriter
      Inherits HtmlTextWriter
      
      Public Sub New(writer As TextWriter)
         MyBase.New(writer)
         writer.Write("<font color=blue> 'MyHtmlTextWriter' is used for rendering.</font>")
      End Sub 'New
   End Class 'MyHtmlTextWriter
End Namespace 'WebPage

namespace WebPage
{
   using System;
   using System.IO;
   using System.Web.UI;

   public class MyPage : Page
   {
      public MyPage():base()
      {
      }

      [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
      protected override HtmlTextWriter CreateHtmlTextWriter(TextWriter writer)
      {
         return new MyHtmlTextWriter(writer);
      }

      [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
      protected override void Render(HtmlTextWriter writer)
      {         
         // Write a Font control.
         writer.AddAttribute("color", "red");
         writer.AddAttribute("size", "6pt");
         writer.RenderBeginTag(HtmlTextWriterTag.Font);
         writer.Write("<br>" + "The time on the server:<br> " + System.DateTime.Now.ToLongTimeString());
         writer.RenderEndTag();
      }
   }

   public class MyHtmlTextWriter : HtmlTextWriter
   {
      public MyHtmlTextWriter(TextWriter writer):base(writer)
      {
         writer.Write("<font color=blue> 'MyHtmlTextWriter' is used for rendering.</font>");
      }
   }

}

import System.*;  
import System.IO.*;  
import System.Web.UI.*;  
public class MyPage extends Page
{
    public MyPage()
    {
    } //MyPage

    protected HtmlTextWriter CreateHtmlTextWriter(TextWriter writer)
    {
        return new MyHtmlTextWriter(writer);
    } //CreateHtmlTextWriter

    protected void Render(HtmlTextWriter writer)
    {
        // Write a Font control.
        writer.AddAttribute("color", "red");
        writer.AddAttribute("size", "6pt");
        writer.RenderBeginTag(HtmlTextWriterTag.Font);
        writer.Write("<br>" + "The time on the server:<br> " 
            + System.DateTime.get_Now().ToLongTimeString());
        writer.RenderEndTag();
    } //Render
} //MyPage

public class MyHtmlTextWriter extends HtmlTextWriter
{
    public MyHtmlTextWriter(TextWriter writer)
    {
        super(writer);
        writer.Write("<font color=blue> 'MyHtmlTextWriter' is used for "
            + "rendering.</font>");
    } //MyHtmlTextWriter
} //MyHtmlTextWriter

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Page-Klasse
Page-Member
System.Web.UI-Namespace
HtmlTextWriter-Klasse
Html32TextWriter-Klasse
HttpBrowserCapabilities
CreateHtmlTextWriterFromType
ControlAdapter

Weitere Ressourcen

browserCaps-Element (ASP.NET-Einstellungsschema)