Page.CreateHtmlTextWriter メソッド

.NET Framework クラス ライブラリ リファレンス

Page.CreateHtmlTextWriter メソッド

ページの内容を表示する HtmlTextWriter オブジェクトを作成します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Friend Overridable
 Function CreateHtmlTextWriter ( _
    tw As TextWriter _
) As HtmlTextWriter

Visual Basic (使用法)

Dim tw As TextWriter
Dim returnValue As HtmlTextWriter

returnValue = Me.CreateHtmlTextWriter(tw)

C#

protected internal virtual HtmlTextWriter CreateHtmlTextWriter
 (
    TextWriter tw
)

C++

protected public:
virtual HtmlTextWriter^ CreateHtmlTextWriter (
    TextWriter^ tw
)

J#

protected HtmlTextWriter CreateHtmlTextWriter (
    TextWriter tw
)

JScript

protected internal function
 CreateHtmlTextWriter (
    tw : TextWriter
) : HtmlTextWriter

パラメータ

tw

HtmlTextWriter を作成するために使用する TextWriter。

戻り値
HtmlTextWriter または Html32TextWriter。

解説

CreateHtmlTextWriter メソッドは、ページ要求に関連付けられている Request オブジェクトの Browser プロパティを通じて TextWriter を作成します。browserCaps 構成セクションの HtmlTextWriter に参照を追加できます。カスタムの参照を実行するには CreateHtmlTextWriter メソッドをオーバーライドします。

使用例

CreateHtmlTextWriter メソッドを使用して、MyHtmlTextWriter という名前のカスタム HtmlTextWriter オブジェクトのインスタンスを作成するコード例を次に示します。CreateHtmlTextWriter メソッドは、Page から派生した MyPage クラスでオーバーライドされます。このため、MyHtmlTextWriter は、ページの要求時に ASP.NET サーバー コントロールを表示します。この例では、アダプタの TextWriter 動作が実行されないようになっています。

Visual Basic

Imports System
Imports System.IO
Imports System.Web.UI

Namespace WebPage

    
   Public Class MyPage
      Inherits Page
      
      Public Sub New()
         MyBase.New()
      End Sub 'New

      <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 'Render
   End Class 'MyPage
    

   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 'New
   End Class 'MyHtmlTextWriter
End Namespace 'WebPage

C#

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>");
      }
   }

}

J#

import System.*;  
import System.IO.*;  
import System.Web.UI.*;  
public class MyPage extends Page
{
    public MyPage()
    {
    } //MyPage

    protected HtmlTextWriter CreateHtmlTextWriter(TextWriter writer)
    {
        return new MyHtmlTextWriter(writer);
    } //CreateHtmlTextWriter

    protected 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.get_Now().ToLongTimeString());
        writer.RenderEndTag();
    } //Render
} //MyPage

public class MyHtmlTextWriter extends HtmlTextWriter
{
    public MyHtmlTextWriter(TextWriter writer)
    {
        super(writer);
        writer.Write("<font color=blue> 'MyHtmlTextWriter' is used for
 "
            + "rendering.</font>");
    } //MyHtmlTextWriter
} //MyHtmlTextWriter

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Page クラス
Page メンバ
System.Web.UI 名前空間
HtmlTextWriter クラス
Html32TextWriter クラス
HttpBrowserCapabilities
CreateHtmlTextWriterFromType
ControlAdapter
その他の技術情報
browserCaps 要素 (ASP.NET 設定スキーマ)