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- 继承
示例
下面的代码示例演示如何创建一个名为 CustomChtmlTextWriter 的类，该类派生自 ChtmlTextWriter 类。 它创建两个构造函数并重写 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 类，其大部分功能由所有标记文本编写器（即 HtmlTextWriter 类）的 Html32TextWriter 和基类提供。
构造函数
| 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) |
