語言

ChtmlTextWriter 建構函式

定義

初始化 ChtmlTextWriter 類別的新執行個體。

多載

名稱 Description
ChtmlTextWriter(TextWriter)

初始化一個使用ChtmlTextWriter常數縮排行列的新類別實例DefaultTabString。

ChtmlTextWriter(TextWriter, String)

初始化一個新的類別實例 ChtmlTextWriter ,並以指定的行縮排。

ChtmlTextWriter(TextWriter)

初始化一個使用ChtmlTextWriter常數縮排行列的新類別實例DefaultTabString。

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)

參數

writer
TextWriter

那 TextWriter 就是渲染標記內容的。

範例

以下程式碼範例示範如何建立一個名為 ChtmlCustomPageAdapter 的類別,並定義了一個方法, CreateCustomChtmlTextWriter該方法會建立並回傳該 CustomChtmlTextWriter 類別的實例。 接著,他們 CustomChtmlTextWriter 會將頁面的 cHTML 內容渲染到帶有 cHTML 標記的瀏覽器裝置。

此程式碼範例是本類別更大範例 ChtmlTextWriter 的一部分。

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

備註

該 ChtmlTextWriter 類別有兩個構造子,這是所有直接或間接從該 HtmlTextWriter 類別衍生的類別的標準配置。

ChtmlTextWriter建構子以類別的TextWriter實例為參數,呼叫第二個建構子並傳遞兩個參數值:

適用於

ChtmlTextWriter(TextWriter, String)

初始化一個新的類別實例 ChtmlTextWriter ,並以指定的行縮排。

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)

參數

writer
TextWriter

那 TextWriter 就是渲染標記內容的。

tabString
String

定義在 Indent中的空間數量。

範例

以下程式碼範例示範如何建立一個由 CustomChtmlTextWriter 該 ChtmlTextWriter 類別衍生的自訂類別。 它會建立兩個建構子,你可以用來建立一個自訂類別的實例,其模式與所有直接或間接衍生自該 HtmlTextWriter 類別的類別相同。

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

備註

ChtmlTextWriter建構子同時接受類別的TextWriter實例與字串作為參數,並呼叫Html32TextWriter取相同參數的建構子,當它建立類別實例ChtmlTextWriter時。

適用於