ChtmlTextWriter Konstruktoren

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Initialisiert eine neue Instanz der ChtmlTextWriter-Klasse.

Überlädt

ChtmlTextWriter(TextWriter)	Initialisiert eine neue Instanz der ChtmlTextWriter-Klasse, die für den Zeileneinzug die DefaultTabString-Konstante verwendet.
ChtmlTextWriter(TextWriter, String)	Initialisiert eine neue Instanz der ChtmlTextWriter-Klasse mit dem angegebenen Zeileneinzug.

ChtmlTextWriter(TextWriter)

Initialisiert eine neue Instanz der ChtmlTextWriter-Klasse, die für den Zeileneinzug die DefaultTabString-Konstante 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

Der TextWriter, der den Inhalt des Markups rendert.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Klasse mit dem Namen ChtmlCustomPageAdapter erstellt und eine Methode definiert wird, CreateCustomChtmlTextWriterdie eine instance der CustomChtmlTextWriter Klasse erstellt und zurückgibt. Anschließend CustomChtmlTextWriter werden cHTML-Inhalte für Seiten auf Geräten mit Browsern gerendert, 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. Dies ist Standard für alle Klassen, die direkt oder indirekt von der HtmlTextWriter -Klasse abgeleitet werden.

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

• Die TextWriter.

• Der im Feld angegebene Zeichenfolgenwert, der DefaultTabString den Registerkartenabstand definiert, der vom XHTML-Textwriter verwendet wird.

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

Der TextWriter, der den Inhalt des Markups rendert.

tabString

String

Die Anzahl der in Indent definierten Abstände.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine benutzerdefinierte Klasse mit dem Namen CustomChtmlTextWriter erstellt wird, die von der ChtmlTextWriter -Klasse abgeleitet wird. Sie erstellt zwei Konstruktoren, die Sie verwenden können, um eine instance der benutzerdefinierten Klasse mit dem gleichen Muster wie alle Klassen zu erstellen, 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 instance der TextWriter -Klasse als auch eine Zeichenfolge als Parameter akzeptiert, ruft den Html32TextWriter Konstruktor auf, der dieselben Parameter annimmt, wenn er eine instance der ChtmlTextWriter -Klasse erstellt.