ChtmlTextWriter Konstruktoren
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, CreateCustomChtmlTextWriter
die 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.
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
Der TextWriter, der den Inhalt des Markups rendert.
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.