HtmlTextWriter 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將標記字元和文字寫入至 ASP.NET 伺服器控制輸出數據流。 這個類別提供格式化功能，ASP.NET 伺服器控制件在將標記轉譯至用戶端時使用。
public ref class HtmlTextWriter : System::IO::TextWriterpublic class HtmlTextWriter : System.IO.TextWritertype HtmlTextWriter = class
inherit TextWriterPublic Class HtmlTextWriter
Inherits TextWriter- 繼承
- 衍生
範例
下列程式代碼範例示範如何覆寫衍生自 Control 類別之自定義控件的 Render 方法。 程式代碼範例說明如何使用各種 HtmlTextWriter 方法、屬性和欄位。
// Overrides the Render method to write a <span> element
// that applies styles and attributes.
protected override void Render(HtmlTextWriter writer)
{
// Set attributes and values along with attributes and styles
// attribute defined for a <span> element.
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
writer.AddAttribute("CustomAttribute", "CustomAttributeValue");
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red");
writer.AddStyleAttribute("Customstyle", "CustomStyleValue");
writer.RenderBeginTag(HtmlTextWriterTag.Span);
// Create a space and indent the markup inside the
// <span> element.
writer.WriteLine();
writer.Indent++;
writer.Write("Hello");
writer.WriteLine();
// Controls the encoding of markup attributes
// for an <img> element. Simple known values
// do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt,
"Encoding, \"Required\"",
true);
writer.AddAttribute("myattribute",
"No "encoding " required",
false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();
// Create a non-standard markup element.
writer.RenderBeginTag("MyTag");
writer.Write("Contents of MyTag");
writer.RenderEndTag();
writer.WriteLine();
// Create a manually rendered <img> element
// that contains an alt attribute.
writer.WriteBeginTag("img");
writer.WriteAttribute("alt", "A custom image.");
writer.Write(HtmlTextWriter.TagRightChar);
writer.WriteEndTag("img");
writer.WriteLine();
writer.Indent--;
writer.RenderEndTag();
}
' Overrides the Render method to write a <span> element
' that applies styles and attributes.
Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)
' Set attributes and values along with attributes and styles
' attribute defined for a <span> element.
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")
writer.AddAttribute("CustomAttribute", "CustomAttributeValue")
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red")
writer.AddStyleAttribute("CustomStyle", "CustomStyleValue")
writer.RenderBeginTag(HtmlTextWriterTag.Span)
' Create a space and indent the markup inside the
' <span> element.
writer.WriteLine()
writer.Indent += 1
writer.Write("Hello")
writer.WriteLine()
' Controls the encoding of markup attributes
' for an <img> element. Simple known values
' do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, _
"Encoding, ""Required""", _
True)
writer.AddAttribute("myattribute", _
"No "encoding " required", _
False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()
' Create a non-standard markup element.
writer.RenderBeginTag("Mytag")
writer.Write("Contents of MyTag")
writer.RenderEndTag()
writer.WriteLine()
' Create a manually rendered <img> element
' that contains an alt attribute.
writer.WriteBeginTag("img")
writer.WriteAttribute("alt", "A custom image.")
writer.Write(HtmlTextWriter.TagRightChar)
writer.WriteEndTag("img")
writer.WriteLine()
writer.Indent -= 1
writer.RenderEndTag()
End Sub
備註
HtmlTextWriter 類別可用來將 HTML 4.0 轉譯至桌面瀏覽器。 HtmlTextWriter 也是 System.Web.UI 命名空間中所有標記寫入器的基類，包括 ChtmlTextWriter、Html32TextWriter和 XhtmlTextWriter 類別。 這些類別可用來為不同類型的標記撰寫元素、屬性和樣式和版面配置資訊。 此外，頁面和控件配接器類別會使用這些類別，這些類別會與每個標記語言相關聯。
在大部分情況下，ASP.NET 會自動針對要求裝置使用適當的寫入器。 不過，如果您建立自定義文字寫入器，或想要指定特定寫入器來轉譯特定裝置的頁面，則必須將寫入器對應至應用程式 .browser 檔案的 controlAdapters 區段中的頁面。
建構函式
| HtmlTextWriter(TextWriter) |
初始化使用預設索引標籤字串之 HtmlTextWriter 類別的新實例。 |
| HtmlTextWriter(TextWriter, String) |
使用指定的索引標籤字串字元，初始化 HtmlTextWriter 類別的新實例。 |
欄位
| CoreNewLine |
儲存用於這個 |
| DefaultTabString |
表示單一索引標籤字元。 |
| DoubleQuoteChar |
表示引號 （“） 字元。 |
| EndTagLeftChars |
代表標記項目結尾標記的左角括弧和斜線標記 （</）。 |
| EqualsChar |
代表等號 （ |
| EqualsDoubleQuoteString |
代表字串 （=） 中的等號 （=） 和雙引號 （“） 在一起。 |
| SelfClosingChars |
表示標記標記的空格和自我右斜線標記 （/）。 |
| SelfClosingTagEnd |
代表自我結尾標記專案的右斜線標記和右角括號（/>）。 |
| SemicolonChar |
表示分號 （;)。 |
| SingleQuoteChar |
代表單引號 （'）。 |
| SlashChar |
代表斜線標記 （/）。 |
| SpaceChar |
表示空格 （） 字元。 |
| StyleEqualsChar |
表示用來設定樣式屬性等於值之樣式屬性的樣式等於 （ |
| TagLeftChar |
代表標記標記的左角括弧 （<）。 |
| TagRightChar |
代表標記標記的右角括弧 （>）。 |
屬性
| Encoding |
取得 HtmlTextWriter 物件用來將內容寫入頁面的編碼方式。 |
| FormatProvider |
取得控制項格式設定的物件。 (繼承來源 TextWriter) |
| Indent |
取得或設定要縮排每個標記行開頭的定位點位置數目。 |
| InnerWriter |
取得或設定寫入標記項目內部內容的文字寫入器。 |
| NewLine |
取得或設定 HtmlTextWriter 物件所使用的行終止符字串。 |
| TagKey |
取得或設定指定標記專案的 HtmlTextWriterTag 值。 |
| TagName |
取得或設定要轉譯之標記項目的標記名稱。 |
方法
明確介面實作
| IDisposable.Dispose() |
如需此成員的描述，請參閱 Dispose()。 (繼承來源 TextWriter) |
