XhtmlTextWriter 클래스

정의

public ref class XhtmlTextWriter : System::Web::UI::HtmlTextWriter

public class XhtmlTextWriter : System.Web.UI.HtmlTextWriter

type XhtmlTextWriter = class
    inherit HtmlTextWriter

Public Class XhtmlTextWriter
Inherits HtmlTextWriter

상속

Object

MarshalByRefObject

TextWriter

HtmlTextWriter

XhtmlTextWriter

예제

이 섹션의 코드 예제에는 네 부분으로 구성됩니다. 첫 번째 예제에서는 파생 클래스를 만드는 방법을 보여 줍니다. 두 번째 코드 예제에서는 사용자 지정 컨트롤을 만드는 방법을 보여 줍니다. 세 번째 코드 예제에서는 사용자 지정 컨트롤을 사용하는 방법을 보여 줍니다. 네 번째 코드 예제에서는 사용자 지정 컨트롤을 실행하는 데 필요한 코드를 제공합니다.

다음 코드 예제에서는 만드는 방법을 보여 줍니다는 클래스에서 XhtmlTextWriter 파생 되는 사용자 지정 클래스입니다. 클래스에서 HtmlTextWriter 직접 또는 간접적으로 상속하는 모든 클래스에 대한 표준인 두 개의 생성자가 있습니다. 첫 번째 생성자는 개체를 TextWriter 매개 변수로 사용하고 두 번째 생성자를 호출하여 다음 두 매개 변수 값을 전달합니다.

• TextWriter 인스턴스입니다.

• XHTML 텍스트 기록기에서 사용하는 기본 줄 들여쓰기를 정의하는 속성의 값 HtmlTextWriter.DefaultTabString 입니다.

이 코드 예제에서는 및 메서드를 재정의 OnAttributeRenderOnStyleAttributeRender 하여 텍스트 크기와 색 스타일을 각각 필터링하는 방법도 보여 줍니다. 또한 및 메서드를 재정의 BeginRenderEndRender 하여 컨트롤이 렌더링되기 전과 후에 텍스트 문자열을 작성합니다.

using System;
using System.IO;
using System.Web;
using System.Security.Permissions;
using System.Web.UI;
using System.Web.UI.Adapters;
using System.Web.UI.WebControls.Adapters;

namespace Samples.AspNet.CS
{
    // Create a class that inherits from XhtmlTextWriter.
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level=AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, 
        Level=AspNetHostingPermissionLevel.Minimal)] 
    public class CustomXhtmlTextWriter : XhtmlTextWriter
    {
        // Create two constructors, following 
        // the pattern for implementing a
        // TextWriter constructor.
        public CustomXhtmlTextWriter(TextWriter writer) : 
            this(writer, DefaultTabString)
        {
        }

        public CustomXhtmlTextWriter(TextWriter writer, string tabString) : 
            base(writer, tabString)
        {
        }

        // Override the OnAttributeRender method to 
        // allow this text writer to render only eight-point 
        // text size.
        protected override bool OnAttributeRender(string name, 
          string value, 
          HtmlTextWriterAttribute key) 
        {
            if (key == HtmlTextWriterAttribute.Size)
            {
                if (String.Compare(value, "8pt") == 0)
                {
                    return true;
                }
                else
                {
                   return false;
                } 
             }
             else
             {
                 return base.OnAttributeRender(name, value, key);
             }
         }
        
        // Override the OnStyleAttributeRender
        // method to prevent this text writer 
        // from rendering purple text.
        protected override bool OnStyleAttributeRender(string name, 
            string value, 
            HtmlTextWriterStyle key)
        {
            if (key == HtmlTextWriterStyle.Color)
            {
                if (String.Compare(value, "purple") == 0)
                {
                    return false;
                }
                else
                {
                    return true;
                }
            }
            else
            {
                return base.OnStyleAttributeRender(name, value, key);
            }        
        }  

        // Override the BeginRender method to write a
        // message and call the WriteBreak method
        // before a control is rendered.
        override public void BeginRender()
        {
           this.Write("A control is about to render.");
           this.WriteBreak();
        }
        
        // Override the EndRender method to
        // write a string immediately after 
        // a control has rendered. 
        override public void EndRender()
        {
           this.Write("A control just rendered.");
        }  
    }
}

Imports System.IO
Imports System.Web
Imports System.Security.Permissions
Imports System.Web.UI
Imports System.Web.UI.Adapters
Imports System.Web.UI.WebControls.Adapters

Namespace Samples.AspNet.VB

    ' Create a class that inherits from XhtmlTextWriter.
    <AspNetHostingPermission(SecurityAction.Demand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
        Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public Class CustomXhtmlTextWriter
        Inherits XhtmlTextWriter

        ' Create two constructors, following 
        ' the pattern for implementing a
        ' TextWriter constructor.
        Public Sub New(writer As TextWriter)
          MyClass.New(writer, DefaultTabString)
        End Sub


        Public Sub New(writer As TextWriter, tabString As String)
          MyBase.New(writer, tabString)
        End Sub


        ' Override the OnAttributeRender method to 
        ' allow this text writer to render only eight-point 
        ' text size.
        Overrides Protected Function OnAttributeRender(ByVal name As String, _
          ByVal value As String, _
          ByVal key As HtmlTextWriterAttribute _
        ) As Boolean
           If key = HtmlTextWriterAttribute.Size Then
              If String.Compare(value, "8pt") = 0 Then
                 Return True
              Else
                 Return False
              End If 
           Else
              Return MyBase.OnAttributeRender(name, value, key)
           End If
        End Function
        
        ' Override the OnStyleAttributeRender
        ' method to prevent this text writer 
        ' from rendering purple text.
        Overrides Protected Function OnStyleAttributeRender(ByVal name As String, _
          ByVal value As String, _
          ByVal key As HtmlTextWriterStyle _
        ) As Boolean
           If key = HtmlTextWriterStyle.Color Then
              If String.Compare(value, "purple") = 0 Then
                 Return False
              Else
                 Return True
              End If
           Else
              Return MyBase.OnStyleAttributeRender(name, value, key)        
           End If
        End Function  

        ' Override the BeginRender method to write a
        ' message and call the WriteBreak method
        ' before a control is rendered.
        Overrides Public Sub BeginRender()
           Me.Write("A control is about to render.")
           Me.WriteBreak()
        End Sub
        
        ' Override the EndRender method to
        ' write a string immediately after 
        ' a control has rendered. 
        Overrides Public Sub EndRender()
           Me.Write("A control just rendered.")
        End Sub  
         
    End Class
End Namespace

다음 코드 예제에서는 라는 TestLabel 사용자 지정 Label 컨트롤과 컨트롤의 콘텐츠를 XHTML로 렌더링하는 라는 XhtmlTestLabelAdapter 사용자 지정 어댑터를 만드는 방법을 보여 줍니다.

using System;
using System.Web;
using System.Web.UI;
using System.Web.UI.Adapters;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.Adapters;

namespace AspNet.Samples
{
    // Create a simple class that inherits
    // from the Label class.
    public class TestLabel : Label
    {
        private String _textValue;

        // Override the Text property.
        public override string Text
        {
            get
            {
                return (string)ViewState["Text"];
            }
            set
            {
                ViewState["Text"] = value;
            }
        }
    }
    public class XhtmlTestLabelAdapter : WebControlAdapter
    {
        // Create a control property that accesses the
        // methods and properties of the control.
        protected TestLabel Control
        {
            get
            {
                return (TestLabel)base.Control;
            }
        }

        protected override void Render(HtmlTextWriter writer)
        {
            // Create an instance of the XhtmlTextWriter class,
            // named w, and cast the HtmlTextWriter passed 
            // in the writer parameter to w.
            XhtmlTextWriter w = new XhtmlTextWriter(writer);

            // Create a string variable, named value, to hold
            // the control's Text property value.
            String value = Control.Text;

            // Create a Boolean variable, named attTest,
            // to test whether the Style attribute is 
            // valid in the page that the control is
            // rendered to.
            Boolean attTest = w.IsValidFormAttribute("style");

            // Check whether attTest is true or false.
            // If true, a style is applied to the XHTML
            // content. If false, no style is applied.
            if (attTest)
                w.EnterStyle(Control.ControlStyle);

            // Write the Text property value of the control,
            // a <br> element, and a string. Consider encoding the value using WriteEncodedText.
            w.Write(value);
            w.WriteBreak();
            w.Write("This control conditionally rendered its styles for XHTML.");

            // Check whether attTest is true or false.
            // If true, the XHTML style is closed.
            // If false, nothing is rendered.
            if (attTest)
                w.ExitStyle(Control.ControlStyle);
        }
    }
}

Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.Adapters
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.Adapters

Namespace AspNet.Samples
    ' Create a simple class that inherits
    ' from the Label class.
    Public Class TestLabel
      Inherits Label

      Private textValue As String
      
      ' Override the Text property.
      Overrides Public Property Text As String
         Get
                Return CStr(ViewState("Text"))
         End Get
         
         Set
                ViewState("Text") = Value
         End Set
        End Property

    End Class
    ' Create a class to render the custom Label's
    ' content to XHTML devices.
    Public Class XhtmlTestLabelAdapter
         Inherits WebControlAdapter

   
      ' Create a Control property that accesses the 
      ' methods and properties of the control.
      Protected Shadows ReadOnly Property Control() As TestLabel
         Get
            Return CType(MyBase.Control, TestLabel)
         End Get
      End Property
   
        ' Override the Render method.
        Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)

            ' Create an instance of the XhtmlTextWriter class, 
            ' named w, and cast the HtmlTextWriter passed 
            ' in the writer parameter to w.
            Dim w As XhtmlTextWriter = New XhtmlTextWriter(writer)

            ' Create a string variable, named value, to hold
            ' the control's Text property value.
            Dim value As String = Control.Text

            ' Create a Boolean variable, named attTest,
            ' to test whether the Style attribute is 
            ' valid in the page that the control is
            ' rendered to.
            Dim attTest As Boolean = w.IsValidFormAttribute("style")

            ' Check whether attTest is true or false.
            ' If true, a style is applied to the XHTML
            ' content. If false, no style is applied.
            If (attTest = True) Then
                w.EnterStyle(Control.ControlStyle)
            End If

            ' Write the Text property value of the control,
            ' a <br> element, and a string. Consider encoding the value using WriteEncodedText.
            w.Write(value)
            w.WriteBreak()
            w.Write("This control conditionally rendered its styles for XHTML.")

            ' Check whether attTest is true or false.
            ' If true, the XHTML style is closed.
            ' If false, nothing is rendered.
            If (attTest = True) Then
                w.ExitStyle(Control.ControlStyle)
            End If

        End Sub

    End Class
End Namespace

다음 코드 예제에서는 ASP.NET 웹 페이지에서 사용자 지정 컨트롤 TestLabel 을 사용 하는 방법을 보여 줍니다.

<%@ Page Language="C#" %>
<%@ Import Namespace="AspNet.Samples" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  protected void Page_Load(object sender, EventArgs e)
  {
    TestLabel tl = new TestLabel();
    tl.ID = "TestLabel1";
    PlaceHolder1.Controls.Add(tl);

  }
</script>


<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>XHtmlTextWriter Example</title>
</head>
<body>
    <form id="form1" runat="server" >
    <div>
      <asp:PlaceHolder ID="PlaceHolder1" runat="server"></asp:PlaceHolder>    
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB"   %>
<%@ Import Namespace="AspNet.Samples" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)

    Dim tl As TestLabel = New TestLabel()
    tl.ID = "TestLabel1"
    PlaceHolder1.Controls.Add(tl)
    
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>XHtmlTextWriter Example</title>
</head>
<body>
    <form id="form1" runat="server" >
    <div>
      <asp:PlaceHolder ID="PlaceHolder1" runat="server"></asp:PlaceHolder>    
    </div>
    </form>
</body>
</html>

앞의 코드 예제에서 사용자 지정 컨트롤을 사용하려면 다음 <controlAdapters> 요소를 두 파일 중 하나에 추가합니다. 특정 브라우저에 대한 하위 디렉터리의 적절한 컴퓨터 전체 파일에 .NET Framework 구성 디렉터리의 하위 폴더로 추가할 수 있습니다. 또는 웹 애플리케이션 루트 아래의 App_Browsers 디렉터리에서 사용자 지정 브라우저 파일을 추가할 수 있습니다.

<controlAdapters>  
   <adapter controlType="AspNet.Samples.TestLabel"  
   adapterType="AspNet.Samples.XhtmlTestLabelAdapter" />  
</controlAdapters>  

설명

XHTML은 여러 디바이스 유형에 대해 적합 한 웹 사이트를 만들 수 있는 HTML 4.1 기반, XML 규격 태그 언어입니다. HTML에서 제공하는 사용 편의성을 XML에서 제공하는 엄격한 요소 지침과 병합하여 다양한 형식 및 스타일 옵션과 태그 태그 모호성이 감소된 태그 언어를 생성합니다. 클래스는 XhtmlTextWriter ASP.NET 서버 컨트롤이 클라이언트에 XHTML 콘텐츠를 렌더링할 때 사용하는 서식 지정 기능을 제공합니다. 메서드를 사용하여 텍스트 작성기에서 SetDocType 렌더링하는 XHTML 형식을 지정할 수 있습니다. 지원되는 문서 형식은 열거형에 XhtmlMobileDocType 정의되어 있습니다.

클래스는 XhtmlTextWriter 요소에 대한 두 가지 특성 집합을 렌더링합니다. 하나의 집합은 속성에서 참조되는 공통 특성의 컬렉션입니다 CommonAttributes . 두 번째 집합은 속성에서 ElementSpecificAttributes 참조되는 요소별 특성의 컬렉션입니다. 렌더링되는 요소 및 스타일에 대한 자세한 내용은 W3C(World Wide Web Consortium) 웹 사이트의 XHTML 모듈화 사양을 참조하세요.

클래스의 멤버와 파생 클래스를 XhtmlTextWriter 사용하여 사용자 지정 XHTML 페이지 어댑터 또는 클래스 어댑터에서 사용할 사용자 지정 텍스트 작성기를 만들 수 있습니다. 클래스의 표준 동작을 재정의 XhtmlTextWriter 하는 파생 클래스를 만들 수도 있습니다.

기본적으로 HTML 4.0을 지원하는 브라우저를 사용하는 경우 ASP.NET 페이지 및 컨트롤은 XHTML 1.1 표준과 호환되는 태그를 렌더링합니다. 자세한 내용은 XHTML 표준 Visual Studio 및 ASP.NET에입니다.

XHTML HtmlTextWriter 태그를 렌더링하지 않도록 특별히 ASP.NET 구성하지 않는 한 XHTML을 출력합니다. 자세한 내용은 방법: ASP.NET 웹 사이트에서 XHTML 렌더링 구성을 참조하세요.

생성자

필드

속성

메서드

적용 대상

추가 정보

• ChtmlTextWriter
• ASP.NET 및 XHTML 규격