Page.CreateHtmlTextWriter(TextWriter) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Creates an HtmlTextWriter object to render the page's content.
protected:
virtual System::Web::UI::HtmlTextWriter ^ CreateHtmlTextWriter(System::IO::TextWriter ^ tw);
protected public:
virtual System::Web::UI::HtmlTextWriter ^ CreateHtmlTextWriter(System::IO::TextWriter ^ tw);
protected virtual System.Web.UI.HtmlTextWriter CreateHtmlTextWriter (System.IO.TextWriter tw);
protected internal virtual System.Web.UI.HtmlTextWriter CreateHtmlTextWriter (System.IO.TextWriter tw);
abstract member CreateHtmlTextWriter : System.IO.TextWriter -> System.Web.UI.HtmlTextWriter
override this.CreateHtmlTextWriter : System.IO.TextWriter -> System.Web.UI.HtmlTextWriter
Protected Overridable Function CreateHtmlTextWriter (tw As TextWriter) As HtmlTextWriter
Protected Friend Overridable Function CreateHtmlTextWriter (tw As TextWriter) As HtmlTextWriter
Parameters
- tw
- TextWriter
The TextWriter used to create the HtmlTextWriter.
Returns
An HtmlTextWriter or Html32TextWriter.
Examples
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.RenderBeginTag(HtmlTextWriterTag.Font);
writer.Write("<br>" + "The time on the server:<br> " + System.DateTime.Now.ToLongTimeString());
writer.RenderEndTag();
}
}
public class MyHtmlTextWriter : HtmlTextWriter
{
public MyHtmlTextWriter(TextWriter writer):base(writer)
{
writer.Write("<font color=blue> 'MyHtmlTextWriter' is used for rendering.</font>");
}
}
}
Imports System.IO
Imports System.Web.UI
Namespace WebPage
Public Class MyPage
Inherits Page
Public Sub New()
MyBase.New()
End Sub
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Function CreateHtmlTextWriter(ByVal writer As TextWriter) As HtmlTextWriter
Return New MyHtmlTextWriter(writer)
End Function 'CreateHtmlTextWriter
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)
' Writes a Font control.
writer.AddAttribute("color", "red")
writer.AddAttribute("size", "6pt")
writer.RenderBeginTag(HtmlTextWriterTag.Font)
writer.Write(("<br>" + "The time on the server:<br> " + System.DateTime.Now.ToLongTimeString()))
writer.RenderEndTag()
End Sub
End Class
Public Class MyHtmlTextWriter
Inherits HtmlTextWriter
Public Sub New(writer As TextWriter)
MyBase.New(writer)
writer.Write("<font color=blue> 'MyHtmlTextWriter' is used for rendering.</font>")
End Sub
End Class
End Namespace 'WebPage
Remarks
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.
Applies to
See also
.NET