ChtmlTextWriter 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
向 ASP.NET 服务器控件的输出流写入一系列特定于 cHTML 的字符和文本。 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 将 style 属性写入对象的输出流 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
注解
Compact 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。
提交和查看相关反馈