Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

HtmlTextWriter, classe

Écrit des caractères et du texte de balisage dans un flux de sortie de contrôle serveur ASP.NET. Cette classe fournit des fonctionnalités de mise en forme utilisées par les contrôles serveur ASP.NET lors du rendu du balisage sur les clients.

Espace de noms :  System.Web.UI
Assembly :  System.Web (dans System.Web.dll)
public class HtmlTextWriter : TextWriter

Le type HtmlTextWriter expose les membres suivants.

  Nom Description
Méthode publique HtmlTextWriter(TextWriter) Initialise une nouvelle instance de la classe HtmlTextWriter qui utilise une chaîne de tabulation par défaut.
Méthode publique HtmlTextWriter(TextWriter, String) Initialise une nouvelle instance de la classe HtmlTextWriter avec un caractère de chaîne de tabulation spécifié.
Début
  Nom Description
Propriété publique Encoding Obtient l'encodage utilisé par l'objet HtmlTextWriter pour écrire le contenu sur la page. (Substitue TextWriter.Encoding.)
Propriété publique FormatProvider Obtient un objet qui contrôle la mise en forme. (Hérité de TextWriter.)
Propriété publique Indent Obtient ou définit le nombre de tabulations du retrait à respecter au début d'une ligne HTML.
Propriété publique InnerWriter Obtient ou définit le TextWriter à utiliser pour écrire le contenu interne de l'élément de balisage.
Propriété publique NewLine Obtient ou définit la chaîne de terminaison de ligne utilisée pour l'objet HtmlTextWriter. (Substitue TextWriter.NewLine.)
Propriété protégée TagKey Obtient ou définit la valeur HtmlTextWriterTag de l'élément de balisage spécifié.
Propriété protégée TagName Obtient ou définit le nom de balise d'un élément de balisage restitué.
Début
  Nom Description
Méthode publique AddAttribute(HtmlTextWriterAttribute, String) Ajoute l'attribut de balisage et la valeur de l'attribut à la balise d'ouverture de l'élément créée par l'objet HtmlTextWriter à l'aide d'un appel ultérieur à la méthode RenderBeginTag.
Méthode publique AddAttribute(String, String) Ajoute l'attribut et la valeur de balisage spécifiés à la balise d'ouverture de l'élément créée par l'objet HtmlTextWriter à l'aide d'un appel ultérieur à la méthode RenderBeginTag.
Méthode publique AddAttribute(HtmlTextWriterAttribute, String, Boolean) Ajoute l'attribut de balisage et la valeur de l'attribut à la balise d'ouverture de l'élément créée par l'objet HtmlTextWriter à l'aide d'un appel ultérieur à la méthode RenderBeginTag, avec encodage facultatif.
Méthode publique AddAttribute(String, String, Boolean) Ajoute l'attribut et la valeur de balisage spécifiés à la balise d'ouverture de l'élément créée par l'objet HtmlTextWriter à l'aide d'un appel ultérieur à la méthode RenderBeginTag, avec encodage facultatif.
Méthode protégée 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éée par l'objet HtmlTextWriter à l'aide d'un appel ultérieur à la méthode RenderBeginTag.
Méthode publique AddStyleAttribute(HtmlTextWriterStyle, String) Ajoute l'attribut de style de balisage associé à la valeur HtmlTextWriterStyle spécifiée et la valeur de l'attribut à la balise d'ouverture créée par un appel ultérieur à la méthode RenderBeginTag.
Méthode publique AddStyleAttribute(String, String) Ajoute l'attribut de style de balisage spécifié et la valeur de l'attribut à la balise d'ouverture créée par un appel ultérieur à la méthode RenderBeginTag.
Méthode protégée AddStyleAttribute(String, String, HtmlTextWriterStyle) Ajoute l'attribut de style de balisage spécifié et la valeur d'attribut, avec une valeur d'énumération HtmlTextWriterStyle, à la balise d'ouverture créée par un appel ultérieur à la méthode RenderBeginTag.
Méthode publique BeginRender Notifie un objet HtmlTextWriter, ou un objet d'une classe dérivée, qu'un contrôle est sur le point d'être restitué.
Méthode publique Close Ferme l'objet HtmlTextWriter et libère toutes les ressources système qui lui sont associées. (Substitue TextWriter.Close().)
Méthode publique CreateObjRef Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant. (Hérité de MarshalByRefObject.)
Méthode publique Dispose() Libère toutes les ressources utilisées par l'objet TextWriter. (Hérité de TextWriter.)
Méthode protégée Dispose(Boolean) Libère les ressources non managées utilisées par TextWriter et libère éventuellement les ressources managées. (Hérité de TextWriter.)
Méthode protégée EncodeAttributeValue(HtmlTextWriterAttribute, String) Encode la valeur de l'attribut de balisage spécifié selon les exigences de l'objet HttpRequest du contexte actuel.
Méthode protégée EncodeAttributeValue(String, Boolean) Encode la valeur de l'attribut de balisage spécifié selon les exigences de l'objet HttpRequest du contexte actuel.
Méthode protégée EncodeUrl Effectue un encodage URL minimal en convertissant les espaces de l'URL en chaîne « %20 ».
Méthode publique EndRender Notifie 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 les éléments de balisage ouverts dans la méthode BeginRender.
Méthode publique EnterStyle(Style) Écrit la balise d'ouverture d'un élément <span> qui contient des attributs qui implémentent la présentation et la mise en forme des caractères du style spécifié.
Méthode publique EnterStyle(Style, HtmlTextWriterTag) Écrit la balise d'ouverture d'un élément de balisage qui contient des attributs qui implémentent la présentation et la mise en forme des caractères du style spécifié.
Méthode publique Equals(Object) Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode publique ExitStyle(Style) Écrit la balise de fermeture d'un élément <span> pour terminer la disposition et la mise en forme de caractères spécifiées.
Méthode publique ExitStyle(Style, HtmlTextWriterTag) Écrit la balise de fermeture de l'élément de balisage spécifié pour terminer la disposition et la mise en forme de caractères spécifiées.
Méthode protégée FilterAttributes Supprime tous les attributs de style et de balisage sur toutes les propriétés de la page ou du contrôle serveur Web.
Méthode protégée Finalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publique Flush Efface toutes les mémoires tampons pour HtmlTextWriter en cours et provoque l'écriture des données mises en mémoire tampon dans le flux de sortie. (Substitue TextWriter.Flush().)
Méthode protégée GetAttributeKey Obtient la valeur d'énumération HtmlTextWriterAttribute correspondant à l'attribut spécifié.
Méthode protégée GetAttributeName Obtient le nom de l'attribut de balisage associé à la valeur HtmlTextWriterAttribute spécifiée.
Méthode publique GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publique GetLifetimeService Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject.)
Méthode protégée GetStyleKey Obtient la valeur d'énumération HtmlTextWriterStyle correspondant au style spécifié.
Méthode protégée GetStyleName Obtient le nom de l'attribut de style de balisage associé à la valeur d'énumération HtmlTextWriterStyle spécifiée.
Méthode protégée GetTagKey Obtient la valeur d'énumération HtmlTextWriterTag associée à l'élément de balisage spécifié.
Méthode protégée GetTagName Obtient l'élément de balisage associé à la valeur d'énumération HtmlTextWriterTag spécifiée.
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publique InitializeLifetimeService 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.)
Méthode protégée IsAttributeDefined(HtmlTextWriterAttribute) Détermine si l'attribut de balisage spécifié et sa valeur sont rendus au cours de l'appel suivant à la méthode RenderBeginTag.
Méthode protégée IsAttributeDefined(HtmlTextWriterAttribute, String) Détermine si l'attribut de balisage spécifié et sa valeur sont rendus au cours de l'appel suivant à la méthode RenderBeginTag.
Méthode protégée IsStyleAttributeDefined(HtmlTextWriterStyle) Détermine si l'attribut de style de balisage spécifié est rendu au cours de l'appel suivant à la méthode RenderBeginTag.
Méthode protégée IsStyleAttributeDefined(HtmlTextWriterStyle, String) Détermine si l'attribut de style de balisage spécifié et sa valeur sont rendus au cours de l'appel suivant à la méthode RenderBeginTag.
Méthode publique IsValidFormAttribute Active un attribut pour garantir qu'il peut être restitué dans la balise d'ouverture d'un élément de balisage <form>.
Méthode protégée MemberwiseClone() Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode protégée MemberwiseClone(Boolean) Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject.)
Méthode protégée OnAttributeRender Détermine si l'attribut de balisage spécifié et sa valeur peuvent être rendus dans l'élément de balisage actuel.
Méthode protégée OnStyleAttributeRender Détermine si l'attribut de style de balisage spécifié et sa valeur peuvent être rendus dans l'élément de balisage actuel.
Méthode protégée OnTagRender Détermine si l'élément de balisage spécifié sera rendu sur la page qui a effectué la demande.
Méthode protégée OutputTabs Écrit une série de tabulations représentant le niveau de mise en retrait d'une ligne de caractères de balisage.
Méthode protégée PopEndTag Supprime l'élément de balisage enregistré en dernier de la liste d'éléments rendus.
Méthode protégée PushEndTag Enregistre l'élément de balisage spécifié pour utilisation ultérieure lors de la génération de la balise de fin d'un élément de balisage.
Méthode protégée Membre statique RegisterAttribute Inscrit les attributs de balisage, qu'il s'agisse de littéraux ou d'attributs générés dynamiquement, à partir du fichier source, pour qu'ils puissent être correctement rendus au client ayant fait la demande.
Méthode protégée Membre statique RegisterStyle Inscrit les propriétés de style de balisage, qu'il s'agisse de littéraux ou de propriétés générées dynamiquement, à partir du fichier source, pour qu'elles puissent être correctement rendues au client ayant fait la demande.
Méthode protégée Membre statique RegisterTag Inscrit les balises de balisage, qu'il s'agisse de littéraux ou de balises générées dynamiquement, à partir du fichier source, pour qu'elles puissent être correctement rendues au client ayant fait la demande.
Méthode protégée RenderAfterContent Écrit le texte ou l'espacement survenant après le contenu et avant la balise de fermeture de l'élément de balisage à rendre dans le flux de sortie de balisage.
Méthode protégée RenderAfterTag Écrit l'espacement ou le texte survenant après la balise de fermeture d'un élément de balisage.
Méthode protégée RenderBeforeContent Écrit le texte ou l'espacement avant le contenu et après la balise d'ouverture d'un élément de balisage.
Méthode protégée RenderBeforeTag Écrit tout texte ou espacement survenant avant la balise d'ouverture d'un élément de balisage.
Méthode publique 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.
Méthode publique RenderBeginTag(String) Écrit la balise d'ouverture de l'élément de balisage spécifié dans le flux de sortie.
Méthode publique RenderEndTag Écrit la balise de fermeture d'un élément de balisage dans un flux de sortie.
Méthode publique ToString Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Méthode publique Write(Boolean) Écrit dans le flux de sortie la représentation textuelle d'une valeur Boolean, ainsi que tout espacement de tabulation en attente. (Substitue TextWriter.Write(Boolean).)
Méthode publique Write(Char) Écrit dans le flux de sortie la représentation textuelle d'un caractère Unicode, ainsi que tout espacement de tabulation en attente. (Substitue TextWriter.Write(Char).)
Méthode publique Write(Char[]) Écrit dans le flux de sortie la représentation textuelle d'un tableau de caractères Unicode, ainsi que tout espacement de tabulation en attente. (Substitue TextWriter.Write(Char[]).)
Méthode publique Write(Decimal) Écrit, dans le flux de texte, la représentation textuelle d'une valeur décimale. (Hérité de TextWriter.)
Méthode publique Write(Double) Écrit dans le flux de sortie la représentation textuelle d'un nombre à virgule flottante double précision, ainsi que tout espacement de tabulation en attente. (Substitue TextWriter.Write(Double).)
Méthode publique Write(Int32) Écrit dans le flux de sortie la représentation textuelle d'un entier signé de 32 octets, ainsi que tout espacement de tabulation en attente. (Substitue TextWriter.Write(Int32).)
Méthode publique Write(Int64) Écrit dans le flux de sortie la représentation textuelle d'un entier signé de 64 octets, ainsi que tout espacement de tabulation en attente. (Substitue TextWriter.Write(Int64).)
Méthode publique Write(Object) Écrit dans le flux de sortie la représentation textuelle d'un objet, ainsi que tout espacement de tabulation en attente. (Substitue TextWriter.Write(Object).)
Méthode publique Write(Single) Écrit dans le flux de sortie la représentation textuelle d'un nombre à virgule flottante simple précision, ainsi que tout espacement de tabulation en attente. (Substitue TextWriter.Write(Single).)
Méthode publique Write(String) Écrit la chaîne spécifiée dans le flux de sortie, ainsi que tout espacement de tabulation en attente. (Substitue TextWriter.Write(String).)
Méthode publique Write(UInt32) Écrit dans le flux de texte la représentation textuelle d'un entier non signé de 4 octets. (Hérité de TextWriter.)
Méthode publique Write(UInt64) Écrit dans le flux de texte la représentation textuelle d'un entier non signé de 8 octets. (Hérité de TextWriter.)
Méthode publique Write(String, Object) Écrit une chaîne de tabulation et une chaîne mise en forme dans le flux de sortie, en utilisant la même sémantique que la méthode String.Format, ainsi que tout espacement de tabulation en attente. (Substitue TextWriter.Write(String, Object).)
Méthode publique 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 String.Format. (Substitue TextWriter.Write(String, Object[]).)
Méthode publique Write(Char[], Int32, Int32) Écrit dans le flux de sortie la représentation textuelle d'un sous-tableau de caractères Unicode, ainsi que tout espacement de tabulation en attente. (Substitue TextWriter.Write(Char[], Int32, Int32).)
Méthode publique 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 String.Format. (Substitue TextWriter.Write(String, Object, Object).)
Méthode publique Write(String, Object, Object, Object) Écrit une chaîne mise en forme, en utilisant la même sémantique que String.Format. (Hérité de TextWriter.)
Méthode publique WriteAttribute(String, String) Écrit l'attribut de balisage spécifié et sa valeur dans le flux de sortie.
Méthode publique WriteAttribute(String, String, Boolean) Écrit l'attribut de balisage spécifié et sa valeur dans le flux de sortie et écrit, si spécifiée, la valeur encodée.
Méthode publique WriteBeginTag Écrit tout espacement de tabulation et la balise d'ouverture de l'élément de balisage spécifié dans le flux de sortie.
Méthode publique WriteBreak Écrit un élément de balisage <br /> dans le flux de sortie.
Méthode publique WriteEncodedText Encode le texte spécifié pour l'appareil demandeur, puis l'écrit dans le flux de sortie.
Méthode publique WriteEncodedUrl Encode l'URL spécifiée, puis l'écrit dans le flux de sortie. L'URL peut inclure des paramètres.
Méthode publique WriteEncodedUrlParameter Encode le paramètre URL spécifié pour l'appareil demandeur, puis l'écrit dans le flux de sortie.
Méthode publique WriteEndTag Écrit tout espacement de tabulation et la balise de fermeture de l'élément de balisage spécifié.
Méthode publique WriteFullBeginTag Écrit tout espacement de tabulation et la balise d'ouverture de l'élément de balisage spécifié dans le flux de sortie.
Méthode publique WriteLine() Écrit une chaîne de terminaison de ligne dans le flux de sortie. (Substitue TextWriter.WriteLine().)
Méthode publique WriteLine(Boolean) Écrit dans le flux de sortie les espacements de tabulation en attente et la représentation textuelle d'une valeur Boolean, suivis d'une chaîne de terminaison de ligne. (Substitue TextWriter.WriteLine(Boolean).)
Méthode publique WriteLine(Char) Écrit dans le flux de sortie les espacements de tabulation en attente et un caractère Unicode, suivis d'une chaîne de terminaison de ligne. (Substitue TextWriter.WriteLine(Char).)
Méthode publique WriteLine(Char[]) Écrit dans le flux de sortie les espacements de tabulation en attente et un tableau de caractères Unicode, suivis d'une chaîne de terminaison de ligne. (Substitue TextWriter.WriteLine(Char[]).)
Méthode publique WriteLine(Decimal) Écrit dans le flux de texte la représentation textuelle d'une valeur décimale suivie d'un terminateur de ligne. (Hérité de TextWriter.)
Méthode publique WriteLine(Double) Écrit dans le flux de sortie les espacements de tabulation en attente et la représentation textuelle d'un nombre à virgule flottante double précision, suivis d'une chaîne de terminaison de ligne. (Substitue TextWriter.WriteLine(Double).)
Méthode publique WriteLine(Int32) Écrit dans le flux de sortie les espacements de tabulation en attente et la représentation textuelle d'un entier signé de 32 octets, suivis d'une chaîne de terminaison de ligne. (Substitue TextWriter.WriteLine(Int32).)
Méthode publique WriteLine(Int64) Écrit dans le flux de sortie les espacements de tabulation en attente et la représentation textuelle d'un entier signé de 64 octets, suivis d'une chaîne de terminaison de ligne. (Substitue TextWriter.WriteLine(Int64).)
Méthode publique WriteLine(Object) Écrit dans le flux de sortie les espacements de tabulation en attente et la représentation textuelle d'un objet, suivis d'une chaîne de terminaison de ligne. (Substitue TextWriter.WriteLine(Object).)
Méthode publique WriteLine(Single) Écrit dans le flux de sortie les espacements de tabulation en attente et la représentation textuelle d'un nombre à virgule flottante simple précision, suivis d'une chaîne de terminaison de ligne. (Substitue TextWriter.WriteLine(Single).)
Méthode publique WriteLine(String) Écrit dans le flux de sortie les espacements de tabulation en attente et une chaîne de texte, suivis d'une chaîne de terminaison de ligne. (Substitue TextWriter.WriteLine(String).)
Méthode publique WriteLine(UInt32) Écrit dans le flux de sortie les espacements de tabulation en attente et la représentation textuelle d'un entier non signé de 4 octets, suivis d'une chaîne de terminaison de ligne. (Substitue TextWriter.WriteLine(UInt32).)
Méthode publique WriteLine(UInt64) Écrit dans le flux de texte la représentation textuelle d'un entier non signé de 8 octets suivi d'un terminateur de ligne. (Hérité de TextWriter.)
Méthode publique WriteLine(String, Object) Écrit dans le flux de sortie les espacements de tabulation en attente et une chaîne mise en forme contenant la représentation textuelle d'un objet, suivis d'une chaîne de terminaison de ligne. (Substitue TextWriter.WriteLine(String, Object).)
Méthode publique WriteLine(String, Object[]) Écrit dans le flux de sortie les espacements de tabulation en attente et une chaîne mise en forme contenant la représentation textuelle d'un tableau d'objets, suivis d'une chaîne de terminaison de ligne. (Substitue TextWriter.WriteLine(String, Object[]).)
Méthode publique WriteLine(Char[], Int32, Int32) Écrit dans le flux de sortie les espacements de tabulation en attente et un sous-tableau de caractères Unicode, suivis d'une chaîne de terminaison de ligne. (Substitue TextWriter.WriteLine(Char[], Int32, Int32).)
Méthode publique WriteLine(String, Object, Object) Écrit dans le flux de sortie les espacements de tabulation en attente et une chaîne mise en forme contenant la représentation textuelle de deux objets, suivis d'une chaîne de terminaison de ligne. (Substitue TextWriter.WriteLine(String, Object, Object).)
Méthode publique WriteLine(String, Object, Object, Object) Écrit une chaîne mise en forme et une nouvelle ligne, en utilisant la même sémantique que Format. (Hérité de TextWriter.)
Méthode publique WriteLineNoTabs Écrit dans le flux de sortie une chaîne suivie d'une chaîne de terminaison de ligne. Cette méthode ignore tout espacement de tabulation spécifié.
Méthode publique WriteStyleAttribute(String, String) Écrit l'attribut de style spécifié dans le flux de sortie.
Méthode publique WriteStyleAttribute(String, String, Boolean) Écrit l'attribut de style spécifié et sa valeur dans le flux de sortie et encode la valeur, si spécifiée.
Méthode protégée WriteUrlEncodedString Écrit la chaîne spécifiée, en l'encodant conformément aux exigences des URL.
Début
  Nom Description
Champ protégé CoreNewLine Stocke les caractères de saut de ligne utilisés pour ce TextWriter. (Hérité de TextWriter.)
Champ public Membre statique DefaultTabString Représente un caractère tabulation unique.
Champ public Membre statique DoubleQuoteChar Représente le caractère de guillemet (").
Champ public Membre statique EndTagLeftChars Représente le signe « inférieur à » et la barre oblique (</) d'une balise de fermeture d'un élément de balisage.
Champ public Membre statique EqualsChar Représente le signe égal (=).
Champ public Membre statique EqualsDoubleQuoteString Représente un signe égal (=) et un guillemet double (") regroupés dans une chaîne (=").
Champ public Membre statique SelfClosingChars Représente un espace et la marque de barre oblique de fermeture automatique (/) d'une balise.
Champ public Membre statique SelfClosingTagEnd Représente la barre oblique de fermeture et le signe « supérieur à » (/>) d'un élément de balisage de fermeture automatique.
Champ public Membre statique SemicolonChar Représente le point-virgule (;).
Champ public Membre statique SingleQuoteChar Représente une apostrophe (').
Champ public Membre statique SlashChar Représente la barre oblique (/).
Champ public Membre statique SpaceChar Représente un espace ( ).
Champ public Membre statique StyleEqualsChar Représente le caractère égal pour les styles (:) utilisé pour définir des attributs de style égaux aux valeurs.
Champ public Membre statique TagLeftChar Représente le signe d'ouverture (<) d'une balise.
Champ public Membre statique TagRightChar Représente le signe de fermeture (>) d'une balise.
Début

La classe HtmlTextWriter est utilisée pour afficher le HTML 4.0 sur les navigateurs d'ordinateurs de bureau. HtmlTextWriter est également la classe de base pour tous les writers de balisage dans l'espace de noms System.Web.UI, y compris les classes ChtmlTextWriter, Html32TextWriter et XhtmlTextWriter. Ces classes sont utilisées pour écrire les éléments, les attributs et les informations relatives aux styles et à la disposition pour les différents types de balises. De plus, ces classes sont utilisées par les classes d'adaptateur de contrôles et de page qui sont associées à chaque langage de balisage.

Dans la plupart des circonstances, ASP.NET utilise automatiquement le writer approprié pour l'appareil demandeur. Toutefois, si vous créez un TextWriter personnalisé ou si vous souhaitez spécifier un writer particulier pour restituer une page pour un appareil spécifique, vous devez mapper le writer à la page dans la section controlAdapters du fichier browser de l'application.

L'exemple de code suivant montre comment substituer la méthode Render d'un contrôle personnalisé dérivé de la classe Control. L'exemple de code suivant montre comment utiliser les divers champs, propriétés et méthodes HtmlTextWriter.


        // Overrides the Render method to write a <span> element
        // that applies styles and attributes. 
        protected override void Render(HtmlTextWriter writer) 
        {     
            // Set attributes and values along with attributes and styles  
            // attribute defined for a <span> element.
            writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
            writer.AddAttribute("CustomAttribute", "CustomAttributeValue");
            writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red");
            writer.AddStyleAttribute("Customstyle", "CustomStyleValue");
            writer.RenderBeginTag(HtmlTextWriterTag.Span);
            // Create a space and indent the markup inside the 
            // <span> element.
            writer.WriteLine();
            writer.Indent++;
            writer.Write("Hello");
            writer.WriteLine();

            // Controls the encoding of markup attributes
            // for an <img> element. Simple known values 
	        // do not need encoding.
            writer.AddAttribute(HtmlTextWriterAttribute.Alt, 
                "Encoding, \"Required\"", 
                true);
            writer.AddAttribute("myattribute", 
                "No &quot;encoding &quot; required", 
                false);
            writer.RenderBeginTag(HtmlTextWriterTag.Img);
            writer.RenderEndTag();
            writer.WriteLine();

            // Create a non-standard markup element.
            writer.RenderBeginTag("MyTag");
            writer.Write("Contents of MyTag");
            writer.RenderEndTag();
            writer.WriteLine();

            // Create a manually rendered <img> element
            // that contains an alt attribute.
            writer.WriteBeginTag("img");
            writer.WriteAttribute("alt", "A custom image.");
            writer.Write(HtmlTextWriter.TagRightChar);
            writer.WriteEndTag("img");
            writer.WriteLine();

            writer.Indent--;
            writer.RenderEndTag();

        }


.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Cela vous a-t-il été utile ?
(1500 caractères restants)
Contenu de la communauté Ajouter
Annotations FAQ