XhtmlTextWriter Sınıf

Tanım

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

Devralma

Object

MarshalByRefObject

TextWriter

HtmlTextWriter

XhtmlTextWriter

Örnekler

Bu bölümdeki kod örneği dört bölümden oluşur. İlk örnekte türetilmiş bir sınıfın nasıl oluşturulacağı gösterilmektedir. İkinci kod örneğinde özel denetimin nasıl oluşturulacağı gösterilmektedir. Üçüncü kod örneğinde özel denetimin nasıl kullanılacağı gösterilmektedir. Dördüncü kod örneği, özel denetimi çalıştırmak için gereken kodu sağlar.

Aşağıdaki kod örneği, XhtmlTextWriter sınıfından türetilen özel bir sınıfın nasıl oluşturulacağını gösterir. doğrudan veya dolaylı olarak HtmlTextWriter sınıfından devralan tüm sınıflar için standart olan iki oluşturucuya sahiptir. İlk oluşturucu parametre olarak bir TextWriter nesnesi alır ve aşağıdaki iki parametre değerini geçirerek ikinci oluşturucuyu çağırır:

• TextWriter örneği.

• XHTML metin yazıcısı tarafından kullanılan varsayılan satır girintisini tanımlayan HtmlTextWriter.DefaultTabString özelliğinin değeri.

Bu kod örneği, sırasıyla metin boyutu ve renk stili için filtreleme yapmak üzere OnAttributeRender ve OnStyleAttributeRender yöntemlerinin nasıl geçersiz kılınacaklarını da gösterir. Ayrıca, bir denetim işlenmeden önce ve sonra bir metin dizesi yazmak için BeginRender ve EndRender yöntemlerini geçersiz kılar.

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

Aşağıdaki kod örneği, TestLabel adlı özel bir Label denetiminin ve denetimin içeriğini XHTML olarak işleyen XhtmlTestLabelAdapter adlı özel bir bağdaştırıcının nasıl oluşturulacağını gösterir.

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

Aşağıdaki kod örneği, ASP.NET Web sayfasında özel denetim TestLabel nasıl kullanılacağını gösterir.

<%@ 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>

Yukarıdaki kod örneğinde özel denetimi kullanmak için aşağıdaki <controlAdapters> öğesini iki dosyadan birine ekleyin. Bunu, .NET Framework yapılandırma dizininin alt klasörü olarak belirli bir tarayıcının alt dizinindeki uygun makine genelindeki dosyaya ekleyebilirsiniz. Alternatif olarak, web uygulaması kökü altındaki App_Browsers dizinindeki özel bir tarayıcı dosyasına ekleyebilirsiniz.

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

Açıklamalar

XHTML, BIRDEN çok cihaz türü için uygun Web siteleri oluşturmanıza olanak tanıyan HTML 4.1'i temel alan XML uyumlu bir işaretleme dilidir. Html tarafından sağlanan kullanım kolaylığını XML tarafından sağlanan katı öğe yönergeleriyle birleştirerek çok çeşitli biçim ve stil seçeneklerine sahip bir işaretleme dili oluşturur ve biçimlendirme etiketi belirsizliğini azaltır. XhtmlTextWriter sınıfı, ASP.NET sunucu denetimlerinin istemcilere XHTML içeriği işlenirken kullandığı biçimlendirme özellikleri sağlar. Metin yazıcının hangi XHTML türünü işleneceğini belirtmek için SetDocType yöntemini kullanabilirsiniz. Desteklenen belge türleri XhtmlMobileDocType numaralandırmasında tanımlanır.

XhtmlTextWriter sınıfı, öğeler için iki öznitelik kümesi işler. Kümelerden biri, CommonAttributes özelliğinde başvurulmaktadır. İkinci küme, ElementSpecificAttributes özelliğinde belirtildiği gibi öğeye özgü özniteliklerden oluşan bir koleksiyondur. İşlenen öğeler ve stiller hakkında daha fazla bilgi için World Wide Web Consortium (W3C) Web sitesindekiXHTML modülerleştirme belirtimine bakın.

özel XHTML sayfa bağdaştırıcılarında veya sınıf bağdaştırıcılarında kullanılacak özel metin yazıcıları oluşturmak için XhtmlTextWriter sınıfının üyelerini ve türetilmiş sınıfları kullanabilirsiniz. Ayrıca, XhtmlTextWriter sınıfının standart davranışını geçersiz kılan türetilmiş sınıflar da oluşturabilirsiniz.

Varsayılan olarak, HTML 4.0'ı destekleyen tarayıcılarla çalışırken, XHTML 1.1 standardıyla uyumlu sayfaları ve denetimleri işleme işaretlemesini ASP.NET. Daha fazla bilgi için bkz. Visual Studio'da XHTML Standartları've ASP.NET.

HtmlTextWriter, XHTML işaretlemesini işlememek için özel olarak ASP.NET yapılandırmadığınız sürece XHTML çıkışı verir. Daha fazla bilgi için bkz. Nasıl yapılır: ASP.NET Web Sitelerinde XHTML İşlemeyi Yapılandırma.

Oluşturucular

Alanlar

Özellikler

Yöntemler

Şunlara uygulanır

Ayrıca bkz.

• ChtmlTextWriter
• ASP.NET ve XHTML Uyumluluk