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) |
