ChtmlTextWriter Konstruktoren

Definition

Initialisiert eine neue Instanz der ChtmlTextWriter-Klasse.

Überlädt

Name Beschreibung
ChtmlTextWriter(TextWriter)

Initialisiert eine neue Instanz der Klasse, die ChtmlTextWriter die DefaultTabString Konstante zum Einrücken von Zeilen verwendet.

ChtmlTextWriter(TextWriter, String)

Initialisiert eine neue Instanz der ChtmlTextWriter Klasse mit dem angegebenen Zeileneinzug.

ChtmlTextWriter(TextWriter)

Initialisiert eine neue Instanz der Klasse, die ChtmlTextWriter die DefaultTabString Konstante zum Einrücken von Zeilen verwendet.

public:
 ChtmlTextWriter(System::IO::TextWriter ^ writer);
public ChtmlTextWriter(System.IO.TextWriter writer);
new System.Web.UI.ChtmlTextWriter : System.IO.TextWriter -> System.Web.UI.ChtmlTextWriter
Public Sub New (writer As TextWriter)

Parameter

writer
TextWriter

Dadurch TextWriter wird der Markupinhalt gerendert.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Klasse mit dem Namen erstellt ChtmlCustomPageAdapter und eine Methode definiert wird, CreateCustomChtmlTextWriterdie eine Instanz der CustomChtmlTextWriter Klasse erstellt und zurückgibt. Rendert CustomChtmlTextWriter dann cHTML-Inhalt für Seiten auf Geräten mit Browsern, die cHTML-Markup verwenden.

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ChtmlTextWriter Klasse bereitgestellt wird.

// Derive from the WebControlAdapter class,
// provide a CreateCustomChtmlTextWriter
// method to attach to the custom writer.
public class ChtmlCustomPageAdapter : WebControlAdapter
{
    protected internal ChtmlTextWriter CreateCustomChtmlTextWriter(
        TextWriter writer)
    {
        return new CustomChtmlTextWriter(writer);
    }
}
' Derive from the WebControlAdapter class,
' provide a CreateCustomChtmlTextWriter
' method to attach the custom writer.
Public Class ChtmlCustomPageAdapter
    Inherits WebControlAdapter

    Protected Friend Function CreateCustomChtmlTextWriter( _
     ByVal writer As TextWriter) As ChtmlTextWriter

        Return New CustomChtmlTextWriter(writer)

    End Function
End Class

Hinweise

Die ChtmlTextWriter Klasse verfügt über zwei Konstruktoren, die standard für alle Klassen sind, die direkt oder indirekt von der HtmlTextWriter Klasse abgeleitet sind.

Der ChtmlTextWriter Konstruktor, der eine Instanz der TextWriter Klasse als Parameter akzeptiert, ruft den zweiten Konstruktor auf und übergibt ihn zwei Parameterwerte:

  • Die TextWriter.
  • Der im DefaultTabString Feld angegebene Zeichenfolgenwert, der den Tabstoppabstand definiert, der vom XHTML-Textschreiber verwendet wird.

Gilt für:

ChtmlTextWriter(TextWriter, String)

Initialisiert eine neue Instanz der ChtmlTextWriter Klasse mit dem angegebenen Zeileneinzug.

public:
 ChtmlTextWriter(System::IO::TextWriter ^ writer, System::String ^ tabString);
public ChtmlTextWriter(System.IO.TextWriter writer, string tabString);
new System.Web.UI.ChtmlTextWriter : System.IO.TextWriter * string -> System.Web.UI.ChtmlTextWriter
Public Sub New (writer As TextWriter, tabString As String)

Parameter

writer
TextWriter

Dadurch TextWriter wird der Markupinhalt gerendert.

tabString
String

Die Anzahl der leerzeichen, die in der Indent.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine benutzerdefinierte Klasse erstellt CustomChtmlTextWriter wird, die von der ChtmlTextWriter Klasse abgeleitet wird. Sie erstellt zwei Konstruktoren, mit denen Sie eine Instanz der benutzerdefinierten Klasse mit demselben Muster wie alle Klassen erstellen können, die direkt oder indirekt von der HtmlTextWriter Klasse abgeleitet werden.

// Create a class that derives from the
// ChtmlTextWriter class.
using System;
using System.IO;
using System.Web.UI;
using System.Web.UI.WebControls.Adapters;

namespace AspNet.Samples.CS
{
    public class CustomChtmlTextWriter : ChtmlTextWriter
    {
        // Create two constructors for the new
        // text writer.
        public CustomChtmlTextWriter(TextWriter writer) : base(writer, DefaultTabString)
        {
        }

        public CustomChtmlTextWriter(TextWriter writer, String tabString)
            : base(writer, tabString)
        {
        }
        
        // Override the OnAttributeRender method to
        // not render the bgcolor attribute, which is
        // not supported in CHTML.
        protected override bool OnAttributeRender(string name, string value, HtmlTextWriterAttribute key)
        {
            if (String.Equals("bgcolor", name))
            {
                return false;
            }
            
            // Call the ChtmlTextWriter version of the
            // the OnAttributeRender method.
            return base.OnAttributeRender(name, value, key);
        }
    }

    // Derive from the WebControlAdapter class,
    // provide a CreateCustomChtmlTextWriter
    // method to attach to the custom writer.
    public class ChtmlCustomPageAdapter : WebControlAdapter
    {
        protected internal ChtmlTextWriter CreateCustomChtmlTextWriter(
            TextWriter writer)
        {
            return new CustomChtmlTextWriter(writer);
        }
    }
}
' Create a class that derives from the
' ChtmlTextWriter class.
Imports System.IO
Imports System.Web.UI
Imports System.Web.UI.WebControls.Adapters

Namespace AspNet.Samples.VB

    Public Class CustomChtmlTextWriter
        Inherits ChtmlTextWriter

        ' Create two constructors for the new
        ' text writer.
        Public Sub New(ByVal writer As TextWriter)
            MyClass.New(writer, DefaultTabString)
        End Sub

        Public Sub New(ByVal writer As TextWriter, ByVal tabString As String)
            MyBase.New(writer, tabString)
        End Sub

        ' Override the OnAttributeRender method to
        ' not render the bgcolor attribute, which is 
        ' not supported in CHTML.
        Protected Overrides Function OnAttributeRender(ByVal name As String, ByVal value As String, ByVal key As HtmlTextWriterAttribute) As Boolean
            If (String.Equals("bgcolor", name)) Then
                Return False
            End If

            ' Call the ChtmlTextWriter version of 
            ' the OnAttributeRender method.
            MyBase.OnAttributeRender(name, value, key)

        End Function
    End Class

    ' Derive from the WebControlAdapter class,
    ' provide a CreateCustomChtmlTextWriter
    ' method to attach the custom writer.
    Public Class ChtmlCustomPageAdapter
        Inherits WebControlAdapter

        Protected Friend Function CreateCustomChtmlTextWriter( _
         ByVal writer As TextWriter) As ChtmlTextWriter

            Return New CustomChtmlTextWriter(writer)

        End Function
    End Class
End Namespace

Hinweise

Der ChtmlTextWriter Konstruktor, der sowohl eine Instanz der TextWriter Klasse als auch eine Zeichenfolge als Parameter akzeptiert, ruft den Konstruktor auf, der Html32TextWriter dieselben Parameter verwendet, wenn eine Instanz der ChtmlTextWriter Klasse erstellt wird.

Gilt für: