XhtmlTextWriter Classe

Définition

Écrit des caractères spécifiques à XHTML (Extensible Hypertext Markup Language), y compris toutes les variantes de modules XHTML qui dérivent de XHTML, dans le flux de sortie d’un contrôle serveur ASP.NET pour les appareils mobiles. Remplacez la classe XhtmlTextWriter pour fournir un rendu XHTML personnalisé pour les pages et les contrôles serveur ASP.NET.

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
Héritage

Exemples

L’exemple de code de cette section contient quatre parties. Le premier exemple montre comment créer une classe dérivée. Le deuxième exemple de code montre comment créer un contrôle personnalisé. Le troisième exemple de code montre comment utiliser le contrôle personnalisé. Le quatrième exemple de code fournit le code requis pour exécuter le contrôle personnalisé.

L’exemple de code suivant montre comment créer une classe personnalisée dérivée de la classe XhtmlTextWriter. Il a deux constructeurs, qui est standard pour toutes les classes qui héritent directement ou indirectement de la classe HtmlTextWriter. Le premier constructeur prend un objet TextWriter en tant que paramètre et appelle le deuxième constructeur, en passant les deux valeurs de paramètre suivantes :

Cet exemple de code montre également comment remplacer les méthodes OnAttributeRender et OnStyleAttributeRender pour filtrer respectivement la taille du texte et le style de couleur. En outre, il remplace les méthodes BeginRender et EndRender pour écrire une chaîne de texte avant et après le rendu d’un contrôle.

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

L’exemple de code suivant montre comment créer un contrôle de Label personnalisé nommé TestLabel et un adaptateur personnalisé nommé XhtmlTestLabelAdapter qui restitue le contenu du contrôle en tant que XHTML.

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

L’exemple de code suivant montre comment utiliser le contrôle personnalisé TestLabel sur une page web ASP.NET.

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

Pour utiliser le contrôle personnalisé dans l’exemple de code précédent, ajoutez l’élément <controlAdapters> suivant à l’un des deux fichiers. Vous pouvez l’ajouter au fichier à l’échelle de l’ordinateur approprié dans le sous-répertoire d’un navigateur spécifique, en tant que sous-dossier du répertoire de configuration .NET Framework. Vous pouvez également l’ajouter à un fichier de navigateur personnalisé dans le répertoire App_Browsers sous la racine de l’application web.

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

Remarques

XHTML est un langage de balisage compatible XML, basé sur HTML 4.1, qui vous permet de créer des sites Web adaptés à plusieurs types d’appareils. Il fusionne la facilité d’utilisation fournie par HTML avec les instructions d’élément strictes fournies par XML pour produire un langage de balisage avec un large éventail d’options de format et de style, et avec une ambiguïté de balise de balisage réduite. La classe XhtmlTextWriter fournit des fonctionnalités de mise en forme qui ASP.NET contrôles serveur utilisent lors du rendu du contenu XHTML aux clients. Vous pouvez utiliser la méthode SetDocType pour spécifier le type de XHTML rendu par l’enregistreur de texte. Les types de documents pris en charge sont définis dans l’énumération XhtmlMobileDocType.

La classe XhtmlTextWriter affiche deux ensembles d’attributs pour les éléments. Un jeu est une collection d’attributs communs, comme indiqué dans la propriété CommonAttributes. Le deuxième jeu est une collection d’attributs spécifiques à l’élément, comme indiqué dans la propriété ElementSpecificAttributes. Pour plus d’informations sur les éléments et les styles affichés, consultez la spécification de modularisation XHTML au site web World Wide Web Consortium (W3C).

Vous pouvez utiliser les membres de la classe XhtmlTextWriter et toutes les classes dérivées pour créer des enregistreurs de texte personnalisés à utiliser dans des adaptateurs de pages XHTML personnalisés ou des adaptateurs de classe. Vous pouvez également créer des classes dérivées qui remplacent le comportement standard de la classe XhtmlTextWriter.

Par défaut, lorsque vous utilisez des navigateurs qui prennent en charge HTML 4.0, ASP.NET pages et contrôles affichent le balisage compatible avec la norme XHTML 1.1. Pour plus d’informations, consultez normes XHTML dans Visual Studio et ASP.NET.

Le HtmlTextWriter génère XHTML, sauf si vous configurez ASP.NET spécifiquement pour ne pas afficher le balisage XHTML. Pour plus d’informations, consultez How to : Configure XHTML Rendering in ASP.NET Web Sites.

Constructeurs

XhtmlTextWriter(TextWriter)

Initialise une nouvelle instance de la classe XhtmlTextWriter qui utilise la mise en retrait de ligne spécifiée dans le champ DefaultTabString. Utilisez le constructeur XhtmlTextWriter(TextWriter) si vous ne souhaitez pas modifier la mise en retrait de ligne par défaut.

XhtmlTextWriter(TextWriter, String)

Initialise une nouvelle instance de la classe XhtmlTextWriter avec la mise en retrait de ligne spécifiée.

Champs

CoreNewLine

Stocke les caractères de ligne utilisés pour cette TextWriter.

(Hérité de TextWriter)
DefaultTabString

Représente un seul caractère d’onglet.

(Hérité de HtmlTextWriter)
DoubleQuoteChar

Représente le caractère entre guillemets (") .

(Hérité de HtmlTextWriter)
EndTagLeftChars

Représente le crochet gauche et la barre oblique (</) de la balise fermante d’un élément de balisage.

(Hérité de HtmlTextWriter)
EqualsChar

Représente le signe égal (=).

(Hérité de HtmlTextWriter)
EqualsDoubleQuoteString

Représente un signe égal (=) et un guillemet double (« ) ensemble dans une chaîne (= »).

(Hérité de HtmlTextWriter)
SelfClosingChars

Représente un espace et la barre oblique auto-fermante (/) d’une balise de balisage.

(Hérité de HtmlTextWriter)
SelfClosingTagEnd

Représente la barre oblique fermante et le crochet à angle droit (/>) d’un élément de balisage auto-fermant.

(Hérité de HtmlTextWriter)
SemicolonChar

Représente le point-virgule (;).

(Hérité de HtmlTextWriter)
SingleQuoteChar

Représente une apostrophe (').

(Hérité de HtmlTextWriter)
SlashChar

Représente la barre oblique (/).

(Hérité de HtmlTextWriter)
SpaceChar

Représente un espace () caractère.

(Hérité de HtmlTextWriter)
StyleEqualsChar

Représente le style égal (:) caractère utilisé pour définir des attributs de style égaux aux valeurs.

(Hérité de HtmlTextWriter)
TagLeftChar

Représente le crochet angle ouvrant (<) d’une balise de balisage.

(Hérité de HtmlTextWriter)
TagRightChar

Représente le crochet à angle fermant (>) d’une balise de balisage.

(Hérité de HtmlTextWriter)

Propriétés

CommonAttributes

Obtient un objet Hashtable contenant des attributs courants des balises de balisage pour l’objet XhtmlTextWriter.

ElementSpecificAttributes

Obtient un objet Hashtable contenant des attributs spécifiques à l’élément.

Encoding

Obtient l’encodage utilisé par l’objet HtmlTextWriter pour écrire du contenu dans la page.

(Hérité de HtmlTextWriter)
FormatProvider

Obtient un objet qui contrôle la mise en forme.

(Hérité de TextWriter)
Indent

Obtient ou définit le nombre de positions de tabulation à mettre en retrait le début de chaque ligne de balisage.

(Hérité de HtmlTextWriter)
InnerWriter

Obtient ou définit l’enregistreur de texte qui écrit le contenu interne de l’élément de balisage.

(Hérité de HtmlTextWriter)
NewLine

Obtient ou définit la chaîne de fin de ligne utilisée par l’objet HtmlTextWriter.

(Hérité de HtmlTextWriter)
SuppressCommonAttributes

Obtient un objet Hashtable d’éléments pour lesquels CommonAttributes attributs sont supprimés.

TagKey

Obtient ou définit la valeur HtmlTextWriterTag de l’élément de balisage spécifié.

(Hérité de HtmlTextWriter)
TagName

Obtient ou définit le nom de balise de l’élément de balisage en cours de rendu.

(Hérité de HtmlTextWriter)

Méthodes

AddAttribute(HtmlTextWriterAttribute, String)

Ajoute l’attribut de balisage et la valeur d’attribut à la balise d’ouverture de l’élément créé par l’objet HtmlTextWriter avec un appel ultérieur à la méthode RenderBeginTag.

(Hérité de HtmlTextWriter)
AddAttribute(HtmlTextWriterAttribute, String, Boolean)

Ajoute l’attribut de balisage et la valeur d’attribut à la balise d’ouverture de l’élément créé par l’objet HtmlTextWriter avec un appel ultérieur à la méthode RenderBeginTag, avec encodage facultatif.

(Hérité de HtmlTextWriter)
AddAttribute(String, String)

Ajoute l’attribut de balisage et la valeur spécifiés à la balise d’ouverture de l’élément créé par l’objet HtmlTextWriter avec un appel ultérieur à la méthode RenderBeginTag.

(Hérité de HtmlTextWriter)
AddAttribute(String, String, Boolean)

Ajoute l’attribut et la valeur de balisage spécifiés à la balise d’ouverture de l’élément créé par l’objet HtmlTextWriter avec un appel ultérieur à la méthode RenderBeginTag, avec encodage facultatif.

(Hérité de HtmlTextWriter)
AddAttribute(String, String, HtmlTextWriterAttribute)

Ajoute l’attribut et la valeur de balisage spécifiés, ainsi qu’une valeur d’énumération HtmlTextWriterAttribute, à la balise d’ouverture de l’élément créé par l’objet HtmlTextWriter avec un appel ultérieur à la méthode RenderBeginTag.

(Hérité de HtmlTextWriter)
AddRecognizedAttribute(String, String)

Ajoute un attribut à un élément XHTML. La collection d’attributs spécifiques à l’élément pour l’objet XhtmlTextWriter est référencée par la propriété ElementSpecificAttributes.

AddStyleAttribute(HtmlTextWriterStyle, String)

Ajoute l’attribut de style de balisage associé à la valeur HtmlTextWriterStyle spécifiée et la valeur d’attribut à la balise de balisage ouvrante créée par un appel ultérieur à la méthode RenderBeginTag.

(Hérité de HtmlTextWriter)
AddStyleAttribute(String, String)

Ajoute l’attribut de style de balisage spécifié et la valeur d’attribut à la balise de balisage ouvrante créée par un appel ultérieur à la méthode RenderBeginTag.

(Hérité de HtmlTextWriter)
AddStyleAttribute(String, String, HtmlTextWriterStyle)

Ajoute l’attribut de style de balisage spécifié et la valeur de l’attribut, ainsi qu’une valeur d’énumération HtmlTextWriterStyle, à la balise de balisage ouvrante créée par un appel ultérieur à la méthode RenderBeginTag.

(Hérité de HtmlTextWriter)
BeginRender()

Notifie un objet HtmlTextWriter ou un objet d’une classe dérivée, qu’un contrôle est sur le point d’être rendu.

(Hérité de HtmlTextWriter)
Close()

Ferme l’objet HtmlTextWriter et libère toutes les ressources système associées.

(Hérité de HtmlTextWriter)
CreateObjRef(Type)

Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant.

(Hérité de MarshalByRefObject)
Dispose()

Libère toutes les ressources utilisées par l’objet TextWriter.

(Hérité de TextWriter)
Dispose(Boolean)

Libère les ressources non managées utilisées par le TextWriter et libère éventuellement les ressources managées.

(Hérité de TextWriter)
DisposeAsync()

Libère de façon asynchrone toutes les ressources utilisées par l’objet TextWriter.

(Hérité de TextWriter)
EncodeAttributeValue(HtmlTextWriterAttribute, String)

Encode la valeur de l’attribut de balisage spécifié en fonction des exigences de l’objet HttpRequest du contexte actuel.

(Hérité de HtmlTextWriter)
EncodeAttributeValue(String, Boolean)

Encode la valeur de l’attribut de balisage spécifié en fonction des exigences de l’objet HttpRequest du contexte actuel.

(Hérité de HtmlTextWriter)
EncodeUrl(String)

Effectue un encodage d’URL minimal en convertissant des espaces dans l’URL spécifiée en chaîne «%20».

(Hérité de HtmlTextWriter)
EndRender()

Avertit un objet HtmlTextWriter ou un objet d’une classe dérivée qu’un contrôle a terminé le rendu. Vous pouvez utiliser cette méthode pour fermer tous les éléments de balisage ouverts dans la méthode BeginRender().

(Hérité de HtmlTextWriter)
EnterStyle(Style)

Écrit la balise d’ouverture d’un élément <span> qui contient des attributs qui implémentent la mise en forme de disposition et de caractère du style spécifié.

(Hérité de HtmlTextWriter)
EnterStyle(Style, HtmlTextWriterTag)

Écrit la balise d’ouverture d’un élément de balisage qui contient des attributs qui implémentent la mise en forme de disposition et de caractère du style spécifié.

(Hérité de HtmlTextWriter)
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
ExitStyle(Style)

Écrit la balise fermante d’un élément <span> pour mettre fin à la disposition et à la mise en forme de caractères spécifiées.

(Hérité de HtmlTextWriter)
ExitStyle(Style, HtmlTextWriterTag)

Écrit la balise fermante de l’élément de balisage spécifié pour mettre fin à la disposition et à la mise en forme de caractères spécifiées.

(Hérité de HtmlTextWriter)
FilterAttributes()

Supprime tous les attributs de balisage et de style sur toutes les propriétés du contrôle de serveur web ou de page.

(Hérité de HtmlTextWriter)
Flush()

Efface toutes les mémoires tampons de l’objet HtmlTextWriter actuel et provoque l’écriture de toutes les données mises en mémoire tampon dans le flux de sortie.

(Hérité de HtmlTextWriter)
FlushAsync()

Efface de façon asynchrone toutes les mémoires tampons de l’enregistreur actuel et entraîne l’écriture de toutes les données mises en mémoire tampon sur l’appareil sous-jacent.

(Hérité de TextWriter)
FlushAsync(CancellationToken)

Efface de façon asynchrone toutes les mémoires tampons de l’enregistreur actuel et entraîne l’écriture de toutes les données mises en mémoire tampon sur l’appareil sous-jacent.

(Hérité de TextWriter)
GetAttributeKey(String)

Obtient la valeur d’énumération HtmlTextWriterAttribute correspondante pour l’attribut spécifié.

(Hérité de HtmlTextWriter)
GetAttributeName(HtmlTextWriterAttribute)

Obtient le nom de l’attribut de balisage associé à la valeur HtmlTextWriterAttribute spécifiée.

(Hérité de HtmlTextWriter)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetLifetimeService()
Obsolète.

Récupère l’objet de service de durée de vie actuel qui contrôle la stratégie de durée de vie de cette instance.

(Hérité de MarshalByRefObject)
GetStyleKey(String)

Obtient la valeur d’énumération HtmlTextWriterStyle pour le style spécifié.

(Hérité de HtmlTextWriter)
GetStyleName(HtmlTextWriterStyle)

Obtient le nom d’attribut de style de balisage associé à la valeur d’énumération HtmlTextWriterStyle spécifiée.

(Hérité de HtmlTextWriter)
GetTagKey(String)

Obtient la valeur d’énumération HtmlTextWriterTag associée à l’élément de balisage spécifié.

(Hérité de HtmlTextWriter)
GetTagName(HtmlTextWriterTag)

Obtient l’élément de balisage associé à la valeur d’énumération HtmlTextWriterTag spécifiée.

(Hérité de HtmlTextWriter)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
InitializeLifetimeService()
Obsolète.

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.

(Hérité de MarshalByRefObject)
IsAttributeDefined(HtmlTextWriterAttribute)

Détermine si l’attribut de balisage spécifié et sa valeur sont rendus lors de l’appel suivant à la méthode RenderBeginTag.

(Hérité de HtmlTextWriter)
IsAttributeDefined(HtmlTextWriterAttribute, String)

Détermine si l’attribut de balisage spécifié et sa valeur sont rendus lors de l’appel suivant à la méthode RenderBeginTag.

(Hérité de HtmlTextWriter)
IsStyleAttributeDefined(HtmlTextWriterStyle)

Détermine si l’attribut de style de balisage spécifié est rendu pendant l’appel suivant à la méthode RenderBeginTag.

(Hérité de HtmlTextWriter)
IsStyleAttributeDefined(HtmlTextWriterStyle, String)

Détermine si l’attribut de style de balisage spécifié et sa valeur sont rendus lors de l’appel suivant à la méthode RenderBeginTag.

(Hérité de HtmlTextWriter)
IsValidFormAttribute(String)

Vérifie un attribut XHTML pour s’assurer qu’il peut être rendu dans la balise d’ouverture d’un élément <form>.

MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
MemberwiseClone(Boolean)

Crée une copie superficielle de l’objet MarshalByRefObject actuel.

(Hérité de MarshalByRefObject)
OnAttributeRender(String, String, HtmlTextWriterAttribute)

Détermine si l’attribut XHTML spécifié et sa valeur peuvent être restitués à l’élément de balisage actuel.

OnStyleAttributeRender(String, String, HtmlTextWriterStyle)

Détermine si l’attribut de style XHTML spécifié et sa valeur peuvent être restitués à l’élément de balisage actuel.

OnTagRender(String, HtmlTextWriterTag)

Détermine si l’élément de balisage spécifié sera rendu à la page demandée.

(Hérité de HtmlTextWriter)
OutputTabs()

Écrit une série de chaînes d’onglets qui représentent le niveau de retrait pour une ligne de caractères de balisage.

(Hérité de HtmlTextWriter)
PopEndTag()

Supprime l’élément de balisage enregistré le plus récemment dans la liste des éléments rendus.

(Hérité de HtmlTextWriter)
PushEndTag(String)

Enregistre l’élément de balisage spécifié pour une utilisation ultérieure lors de la génération de la balise de fin d’un élément de balisage.

(Hérité de HtmlTextWriter)
RemoveRecognizedAttribute(String, String)

Supprime un attribut de la collection ElementSpecificAttributes d’un élément.

RenderAfterContent()

Écrit tout texte ou espacement qui se produit après le contenu et avant la balise fermante de l’élément de balisage dans le flux de sortie de balisage.

(Hérité de HtmlTextWriter)
RenderAfterTag()

Écrit tout espacement ou texte qui se produit après la balise de fermeture d’un élément de balisage.

(Hérité de HtmlTextWriter)
RenderBeforeContent()

Écrit tout texte ou espacement avant le contenu et après la balise d’ouverture d’un élément de balisage.

(Hérité de HtmlTextWriter)
RenderBeforeTag()

Écrit tout texte ou espacement qui se produit avant la balise d’ouverture d’un élément de balisage.

(Hérité de HtmlTextWriter)
RenderBeginTag(HtmlTextWriterTag)

Écrit la balise d’ouverture de l’élément de balisage associé à la valeur d’énumération HtmlTextWriterTag spécifiée dans le flux de sortie.

(Hérité de HtmlTextWriter)
RenderBeginTag(String)

Écrit la balise d’ouverture de l’élément de balisage spécifié dans le flux de sortie.

(Hérité de HtmlTextWriter)
RenderEndTag()

Écrit la balise de fin d’un élément de balisage dans le flux de sortie.

(Hérité de HtmlTextWriter)
SetDocType(XhtmlMobileDocType)

Spécifie le type de document XHTML pour que l’enregistreur de texte s’affiche sur la page ou le contrôle.

ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)
Write(Boolean)

Écrit la représentation textuelle d’une valeur booléenne dans le flux de sortie, ainsi que tout espacement de tabulation en attente.

(Hérité de HtmlTextWriter)
Write(Char)

Écrit la représentation textuelle d’un caractère Unicode dans le flux de sortie, ainsi que tout espacement de tabulation en attente.

(Hérité de HtmlTextWriter)
Write(Char[])

Écrit la représentation textuelle d’un tableau de caractères Unicode dans le flux de sortie, ainsi que tout espacement de tabulation en attente.

(Hérité de HtmlTextWriter)
Write(Char[], Int32, Int32)

Écrit la représentation textuelle d’un sous-tableau de caractères Unicode dans le flux de sortie, ainsi que tout espacement de tabulation en attente.

(Hérité de HtmlTextWriter)
Write(Decimal)

Écrit la représentation textuelle d’une valeur décimale dans le flux de texte.

(Hérité de TextWriter)
Write(Double)

Écrit la représentation textuelle d’un nombre à virgule flottante double précision dans le flux de sortie, ainsi que tout espacement de tabulation en attente.

(Hérité de HtmlTextWriter)
Write(Int32)

Écrit la représentation textuelle d’un entier signé de 32 octets dans le flux de sortie, ainsi que tout espacement de tabulation en attente.

(Hérité de HtmlTextWriter)
Write(Int64)

Écrit la représentation textuelle d’un entier signé de 64 octets dans le flux de sortie, ainsi que tout espacement de tabulation en attente.

(Hérité de HtmlTextWriter)
Write(Object)

Écrit la représentation textuelle d’un objet dans le flux de sortie, ainsi que tout espacement de tabulation en attente.

(Hérité de HtmlTextWriter)
Write(ReadOnlySpan<Char>)

Écrit une étendue de caractères dans le flux de texte.

(Hérité de TextWriter)
Write(Single)

Écrit la représentation textuelle d’un nombre à virgule flottante simple précision dans le flux de sortie, ainsi que tout espacement de tabulation en attente.

(Hérité de HtmlTextWriter)
Write(String)

Écrit la chaîne spécifiée dans le flux de sortie, ainsi que tout espacement de tabulation en attente.

(Hérité de HtmlTextWriter)
Write(String, Object)

Écrit une chaîne tabulation et une chaîne mise en forme dans le flux de sortie, en utilisant la même sémantique que la méthode Format(String, Object), ainsi que tout espacement de tabulation en attente.

(Hérité de HtmlTextWriter)
Write(String, Object, Object)

Écrit une chaîne mise en forme qui contient la représentation textuelle de deux objets dans le flux de sortie, ainsi que tout espacement de tabulation en attente. Cette méthode utilise la même sémantique que la méthode Format(String, Object, Object).

(Hérité de HtmlTextWriter)
Write(String, Object, Object, Object)

Écrit une chaîne mise en forme dans le flux de texte à l’aide de la même sémantique que la méthode Format(String, Object, Object, Object).

(Hérité de TextWriter)
Write(String, Object[])

Écrit une chaîne mise en forme qui contient la représentation textuelle d’un tableau d’objets dans le flux de sortie, ainsi que tout espacement de tabulation en attente. Cette méthode utilise la même sémantique que la méthode Format(String, Object[]).

(Hérité de HtmlTextWriter)
Write(String, ReadOnlySpan<Object>)

Écrit une chaîne mise en forme dans le flux de texte à l’aide de la même sémantique que Format(String, ReadOnlySpan<Object>).

(Hérité de TextWriter)
Write(StringBuilder)

Écrit un générateur de chaînes dans le flux de texte.

(Hérité de TextWriter)
Write(UInt32)

Écrit la représentation textuelle d’un entier non signé de 4 octets dans le flux de texte.

(Hérité de TextWriter)
Write(UInt64)

Écrit la représentation textuelle d’un entier non signé de 8 octets dans le flux de texte.

(Hérité de TextWriter)
WriteAsync(Char)

Écrit un caractère dans le flux de texte de manière asynchrone.

(Hérité de TextWriter)
WriteAsync(Char[])

Écrit un tableau de caractères dans le flux de texte de manière asynchrone.

(Hérité de TextWriter)
WriteAsync(Char[], Int32, Int32)

Écrit un sous-tableau de caractères dans le flux de texte de manière asynchrone.

(Hérité de TextWriter)
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Écrit de façon asynchrone une région de mémoire de caractères dans le flux de texte.

(Hérité de TextWriter)
WriteAsync(String)

Écrit une chaîne dans le flux de texte de manière asynchrone.

(Hérité de TextWriter)
WriteAsync(StringBuilder, CancellationToken)

Écrit de façon asynchrone un générateur de chaînes dans le flux de texte.

(Hérité de TextWriter)
WriteAttribute(String, String)

Écrit l’attribut de balisage et la valeur spécifiés dans le flux de sortie.

(Hérité de HtmlTextWriter)
WriteAttribute(String, String, Boolean)

Écrit l’attribut et la valeur de balisage spécifiés dans le flux de sortie, et, si spécifié, écrit la valeur encodée.

(Hérité de HtmlTextWriter)
WriteBeginTag(String)

Écrit tout espacement de tabulation et la balise d’ouverture de l’élément de balisage spécifié dans le flux de sortie.

(Hérité de HtmlTextWriter)
WriteBreak()

Écrit un élément <br/> dans le flux de sortie XHTML.

WriteEncodedText(String)

Encode le texte spécifié pour l’appareil demandeur, puis l’écrit dans le flux de sortie.

(Hérité de HtmlTextWriter)
WriteEncodedUrl(String)

Encode l’URL spécifiée, puis l’écrit dans le flux de sortie. L’URL peut inclure des paramètres.

(Hérité de HtmlTextWriter)
WriteEncodedUrlParameter(String)

Encode le paramètre d’URL spécifié pour l’appareil demandeur, puis l’écrit dans le flux de sortie.

(Hérité de HtmlTextWriter)
WriteEndTag(String)

Écrit tout espacement de tabulation et la balise fermante de l’élément de balisage spécifié.

(Hérité de HtmlTextWriter)
WriteFullBeginTag(String)

Écrit tout espacement de tabulation et la balise d’ouverture de l’élément de balisage spécifié dans le flux de sortie.

(Hérité de HtmlTextWriter)
WriteLine()

Écrit une chaîne de fin de ligne dans le flux de sortie.

(Hérité de HtmlTextWriter)
WriteLine(Boolean)

Écrit tout espacement de tabulation en attente et la représentation textuelle d’une valeur booléenne, suivie d’une chaîne de fin de ligne, dans le flux de sortie.

(Hérité de HtmlTextWriter)
WriteLine(Char)

Écrit tout espacement de tabulation en attente et un caractère Unicode, suivis d’une chaîne de fin de ligne, dans le flux de sortie.

(Hérité de HtmlTextWriter)
WriteLine(Char[])

Écrit tout espacement de tabulation en attente et tableau de caractères Unicode, suivis d’une chaîne de fin de ligne, dans le flux de sortie.

(Hérité de HtmlTextWriter)
WriteLine(Char[], Int32, Int32)

Écrit tout espacement de tabulation en attente et un sous-narrateur de caractères Unicode, suivis d’une chaîne de fin de ligne, dans le flux de sortie.

(Hérité de HtmlTextWriter)
WriteLine(Decimal)

Écrit la représentation textuelle d’une valeur décimale dans le flux de texte, suivie d’une marque de fin de ligne.

(Hérité de TextWriter)
WriteLine(Double)

Écrit tout espacement de tabulation en attente et la représentation textuelle d’un nombre à virgule flottante double précision, suivie d’une chaîne de fin de ligne, dans le flux de sortie.

(Hérité de HtmlTextWriter)
WriteLine(Int32)

Écrit tout espacement de tabulation en attente et la représentation textuelle d’un entier signé de 32 octets, suivi d’une chaîne de fin de ligne dans le flux de sortie.

(Hérité de HtmlTextWriter)
WriteLine(Int64)

Écrit tout espacement de tabulation en attente et la représentation textuelle d’un entier signé de 64 octets, suivie d’une chaîne de fin de ligne, dans le flux de sortie.

(Hérité de HtmlTextWriter)
WriteLine(Object)

Écrit tout espacement de tabulation en attente et la représentation textuelle d’un objet, suivie d’une chaîne de fin de ligne, dans le flux de sortie.

(Hérité de HtmlTextWriter)
WriteLine(ReadOnlySpan<Char>)

Écrit la représentation textuelle d’une étendue de caractères dans le flux de texte, suivie d’un terminateur de ligne.

(Hérité de TextWriter)
WriteLine(Single)

Écrit tout espacement de tabulation en attente et la représentation textuelle d’un nombre à virgule flottante simple précision, suivie d’une chaîne de fin de ligne, dans le flux de sortie.

(Hérité de HtmlTextWriter)
WriteLine(String)

Écrit tout espacement de tabulation en attente et une chaîne de texte, suivi d’une chaîne de fin de ligne, dans le flux de sortie.

(Hérité de HtmlTextWriter)
WriteLine(String, Object)

Écrit tout espacement de tabulation en attente et chaîne mise en forme contenant la représentation textuelle d’un objet, suivie d’une chaîne de fin de ligne, dans le flux de sortie.

(Hérité de HtmlTextWriter)
WriteLine(String, Object, Object)

Écrit tout espacement de tabulation en attente et chaîne mise en forme qui contient la représentation textuelle de deux objets, suivie d’une chaîne de fin de ligne, dans le flux de sortie.

(Hérité de HtmlTextWriter)
WriteLine(String, Object, Object, Object)

Écrit une chaîne mise en forme et une nouvelle ligne dans le flux de texte à l’aide de la même sémantique que Format(String, Object).

(Hérité de TextWriter)
WriteLine(String, Object[])

Écrit tout espacement de tabulation en attente et chaîne mise en forme qui contient la représentation textuelle d’un tableau d’objets, suivie d’une chaîne de fin de ligne, dans le flux de sortie.

(Hérité de HtmlTextWriter)
WriteLine(String, ReadOnlySpan<Object>)

Écrit une chaîne mise en forme et une nouvelle ligne dans le flux de texte à l’aide de la même sémantique que Format(String, ReadOnlySpan<Object>).

(Hérité de TextWriter)
WriteLine(StringBuilder)

Écrit la représentation textuelle d’un générateur de chaînes dans le flux de texte, suivie d’une marque de fin de ligne.

(Hérité de TextWriter)
WriteLine(UInt32)

Écrit tout espacement de tabulation en attente et la représentation textuelle d’un entier non signé de 4 octets, suivie d’une chaîne de fin de ligne, dans le flux de sortie.

(Hérité de HtmlTextWriter)
WriteLine(UInt64)

Écrit la représentation textuelle d’un entier non signé de 8 octets dans le flux de texte, suivie d’une marque de fin de ligne.

(Hérité de TextWriter)
WriteLineAsync()

Écrit de façon asynchrone un terminateur de ligne dans le flux de texte.

(Hérité de TextWriter)
WriteLineAsync(Char)

Écrit de façon asynchrone un caractère dans le flux de texte, suivi d’une marque de fin de ligne.

(Hérité de TextWriter)
WriteLineAsync(Char[])

Écrit de façon asynchrone un tableau de caractères dans le flux de texte, suivi d’une marque de fin de ligne.

(Hérité de TextWriter)
WriteLineAsync(Char[], Int32, Int32)

Écrit de façon asynchrone un sous-narrateur de caractères dans le flux de texte, suivi d’une marque de fin de ligne.

(Hérité de TextWriter)
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Écrit de manière asynchrone la représentation textuelle d’une région de mémoire de caractères dans le flux de texte, suivie d’un terminateur de ligne.

(Hérité de TextWriter)
WriteLineAsync(String)

Écrit de façon asynchrone une chaîne dans le flux de texte, suivie d’une marque de fin de ligne.

(Hérité de TextWriter)
WriteLineAsync(StringBuilder, CancellationToken)

Écrit de façon asynchrone la représentation textuelle d’un générateur de chaînes dans le flux de texte, suivie d’une marque de fin de ligne.

(Hérité de TextWriter)
WriteLineNoTabs(String)

Écrit une chaîne, suivie d’une chaîne de fin de ligne, dans le flux de sortie. Cette méthode ignore tout espacement de tabulation spécifié.

(Hérité de HtmlTextWriter)
WriteStyleAttribute(String, String)

Écrit l’attribut de style spécifié dans le flux de sortie.

(Hérité de HtmlTextWriter)
WriteStyleAttribute(String, String, Boolean)

Écrit l’attribut et la valeur de style spécifiés dans le flux de sortie et encode la valeur, le cas échéant.

(Hérité de HtmlTextWriter)
WriteUrlEncodedString(String, Boolean)

Écrit la chaîne spécifiée, en l’encodant en fonction des exigences d’URL.

(Hérité de HtmlTextWriter)

S’applique à

Voir aussi