ChtmlTextWriter 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將一系列 cHTML 特定字元和文字寫入 ASP.NET 伺服器控制項的輸出資料流。 ChtmlTextWriter 類別提供格式化功能，當 ASP.NET 伺服器控制項向用戶端呈現 cHTML 內容時會使用這些格式化功能。
public ref class ChtmlTextWriter : System::Web::UI::Html32TextWriterpublic class ChtmlTextWriter : System.Web.UI.Html32TextWritertype ChtmlTextWriter = class
inherit Html32TextWriterPublic Class ChtmlTextWriter
Inherits Html32TextWriter- 繼承
範例
下列程式碼範例示範如何建立衍生自 類別的 ChtmlTextWriter 類別 CustomChtmlTextWriter 。 它會建立兩個建構函式並覆寫 OnAttributeRender 方法，以防止 bgcolor 樣式屬性寫入物件的輸出資料流程 ChtmlTextWriter 。 它也會建立名為 的 ChtmlCustomPageAdapter 類別，該類別會定義一個方法， CreateCustomChtmlTextWriter 該方法會建立並傳回 類別的 CustomChtmlTextWriter 實例。 接著，會將 CustomChtmlTextWriter 頁面的 cHTML 內容轉譯為具有使用 cHTML 標籤之瀏覽器的裝置。
// 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
備註
精簡 HTML 或 cHTML 是 HTML 2.0、HTML 3.2 和 HTML 4.0 的子集，其設計目的是在具有有限記憶體和 CPU 電源的裝置上轉譯，以及小型顯示畫面、有限的格式設定功能，以及有限的輸入選項數目 (，例如行動電話觸控板) 。 因此，cHTML 不支援下列各項：
JPEG 影像。
資料表。
影像對應。
多個字元字型和樣式。
背景色彩和影像。
框架。
樣式表單。
類別 ChtmlTextWriter 衍生自 Html32TextWriter 類別，而其大部分功能是由 Html32TextWriter 和 所有標記文字寫入器的基類所提供，也就是 HtmlTextWriter 類別。
建構函式
| ChtmlTextWriter(TextWriter) |
使用縮排行的 ChtmlTextWriter 常數，初始化 DefaultTabString 類別的新執行個體。 |
| ChtmlTextWriter(TextWriter, String) |
使用指定的行縮排，初始化 ChtmlTextWriter 類別的新執行個體。 |
欄位
| CoreNewLine |
儲存這個 |
| DefaultTabString |
表示單一定位字元。 (繼承來源 HtmlTextWriter) |
| DoubleQuoteChar |
表示引號 (") 字元。 (繼承來源 HtmlTextWriter) |
| EndTagLeftChars |
表示標記項目結尾標記的左角括弧和斜線符號 (</)。 (繼承來源 HtmlTextWriter) |
| EqualsChar |
表示等號 ( |
| EqualsDoubleQuoteString |
表示組成字串 (=") 的等號 (=) 和雙引號 (")。 (繼承來源 HtmlTextWriter) |
| SelfClosingChars |
表示空格以及標記的自行結尾斜線符號 (/)。 (繼承來源 HtmlTextWriter) |
| SelfClosingTagEnd |
表示自我結尾標記項目的結尾斜線符號和右角括弧 (/>)。 (繼承來源 HtmlTextWriter) |
| SemicolonChar |
表示分號 (;)。 (繼承來源 HtmlTextWriter) |
| SingleQuoteChar |
表示所有格符號 (')。 (繼承來源 HtmlTextWriter) |
| SlashChar |
表示斜線符號 (/)。 (繼承來源 HtmlTextWriter) |
| SpaceChar |
表示空格 ( ) 字元。 (繼承來源 HtmlTextWriter) |
| StyleEqualsChar |
表示樣式等號 ( |
| TagLeftChar |
表示標記的開頭角括弧 (<)。 (繼承來源 HtmlTextWriter) |
| TagRightChar |
表示標記的結尾角括弧 (>)。 (繼承來源 HtmlTextWriter) |
屬性
| Encoding |
取得 HtmlTextWriter 物件用來將內容寫入網頁的編碼。 (繼承來源 HtmlTextWriter) |
| FontStack |
取得要呈現之 HTML 的字型資訊集合。 (繼承來源 Html32TextWriter) |
| FormatProvider |
取得控制格式設定的物件。 (繼承來源 TextWriter) |
| GlobalSuppressedAttributes |
取得無法呈現在 cHTML 項目上、全域隱藏屬性的 Hashtable 物件。 |
| Indent |
取得或設定定位點位置的數目，此為標記的每一行開頭要縮排的數目。 (繼承來源 HtmlTextWriter) |
| InnerWriter |
取得或設定寫入標記項目內部內容的文字寫入器。 (繼承來源 HtmlTextWriter) |
| NewLine |
取得或設定 HtmlTextWriter 物件所用的行結束字元字串。 (繼承來源 HtmlTextWriter) |
| RecognizedAttributes |
取得可呈現在 cHTML 項目上、已辨識屬性的 Hashtable 物件。 |
| ShouldPerformDivTableSubstitution |
取得或設定布林值，指出是否將 |
| SupportsBold |
取得或設定布林值，指出提出要求的裝置是否支援粗體 HTML 文字。 請使用 SupportsBold 屬性，條件式地呈現粗體文字至 Html32TextWriter 輸出資料流。 (繼承來源 Html32TextWriter) |
| SupportsItalic |
取得或設定布林值，指出提出要求的裝置是否支援斜體 HTML 文字。 請使用 SupportsItalic 屬性，條件式地呈現斜體文字至 Html32TextWriter 輸出資料流。 (繼承來源 Html32TextWriter) |
| SuppressedAttributes |
取得未呈現在 cHTML 項目上、使用者定義之全域隱藏屬性的 Hashtable 物件。 |
| TagKey |
取得或設定指定標記項目的 HtmlTextWriterTag 值。 (繼承來源 HtmlTextWriter) |
| TagName |
取得或設定所呈現的標記項目的標記名稱。 (繼承來源 HtmlTextWriter) |
方法
適用於
另請參閱
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應