CreateHtmlTextWriter Method
Collapse the table of content
Expand the table of content

Page.CreateHtmlTextWriter Method (TextWriter)


Creates an HtmlTextWriter object to render the page's content.

Namespace:   System.Web.UI
Assembly:  System.Web (in System.Web.dll)

protected internal virtual HtmlTextWriter CreateHtmlTextWriter(
	TextWriter tw


Type: System.IO.TextWriter

The TextWriter used to create the HtmlTextWriter.

The CreateHtmlTextWriter method creates a TextWriter through the Browser property of the Request object associated with the page request. You can add a reference to an HtmlTextWriter in the browserCaps configuration section. Override the CreateHtmlTextWriter method to perform custom lookup.

Legacy Code Example

The following code example uses the CreateHtmlTextWriter method to create an instance of a custom HtmlTextWriter object named MyHtmlTextWriter. The CreateHtmlTextWriter method is overridden in the MyPage class, which is derived from Page, so that MyHtmlTextWriter renders ASP.NET server controls when the page is requested. Note that this example will prevent adapter TextWriter behavior.

namespace WebPage
   using System;
   using System.IO;
   using System.Web.UI;

   public class MyPage : Page
      public MyPage():base()

      [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
      protected override HtmlTextWriter CreateHtmlTextWriter(TextWriter writer)
         return new MyHtmlTextWriter(writer);

      [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
      protected override void Render(HtmlTextWriter writer)
         // Write a Font control.
         writer.AddAttribute("color", "red");
         writer.AddAttribute("size", "6pt");
         writer.Write("<br>" + "The time on the server:<br> " + System.DateTime.Now.ToLongTimeString());

   public class MyHtmlTextWriter : HtmlTextWriter
      public MyHtmlTextWriter(TextWriter writer):base(writer)
         writer.Write("<font color=blue> 'MyHtmlTextWriter' is used for rendering.</font>");


.NET Framework
Available since 1.1
Return to top
© 2015 Microsoft