HtmlTextWriter 类

定义

public ref class HtmlTextWriter : System::IO::TextWriter

public class HtmlTextWriter : System.IO.TextWriter

type HtmlTextWriter = class
    inherit TextWriter

Public Class HtmlTextWriter
Inherits TextWriter

继承

Object

MarshalByRefObject

TextWriter

HtmlTextWriter

派生

System.Web.UI.Html32TextWriter

System.Web.UI.MobileControls.Adapters.MultiPartWriter

System.Web.UI.XhtmlTextWriter

示例

下面的代码示例演示如何重写派生自 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 节中的页面。

构造函数

字段

属性

方法

显式接口实现

适用于

另请参阅

• TextWriter
• Control
• Page
• ControlAdapter
• PageAdapter
• ChtmlTextWriter
• Html32TextWriter
• XhtmlTextWriter
• Render(HtmlTextWriter)