ChtmlTextWriter 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
初始化 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實例為參數,呼叫第二個建構子並傳遞兩個參數值:
- TextWriter。
- 欄位中指定的 DefaultTabString 字串值,定義了 XHTML 文字編寫器所使用的分頁間隔。
適用於
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 就是渲染標記內容的。
範例
以下程式碼範例示範如何建立一個由 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時。