Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout

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
public class HtmlTextWriter extends TextWriter
public class HtmlTextWriter extends TextWriter

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 le périphérique demandeur. Toutefois, si vous créez un TextWriter personnalisé ou si vous souhaitez spécifier un writer particulier pour restituer une page pour un périphérique spécifique, vous devez mapper le writer à la page dans la section controlAdapters du fichier browser de l'application.

RubriqueEmplacement
Procédure pas à pas : développement et utilisation d'un contrôle serveur personnaliséCréation de contrôles ASP.NET
Développement de contrôles serveur Web liés aux données personnalisés pour ASP.NET 1.1Création de contrôles ASP.NET
Développement de contrôles serveur Web liés aux données personnalisés pour ASP.NET 2.0Création de contrôles ASP.NET
Procédure pas à pas : création d'un contrôle Web ASP.NET lié aux données personnalisé pour ASP.NET 2.0Création de contrôles ASP.NET
Procédure pas à pas : création d'un contrôle Web ASP.NET lié aux données personnalisé pour ASP.NET 1.1Création de contrôles ASP.NET
Procédure pas à pas : développement et utilisation d'un contrôle serveur personnaliséGénération d'applications à l'aide de Visual Web Developer
Développement de contrôles serveur Web liés aux données personnalisés pour ASP.NET 1.1Génération d'applications Web ASP.NET dans Visual Studio
Développement de contrôles serveur Web liés aux données personnalisés pour ASP.NET 2.0Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'un contrôle Web ASP.NET lié aux données personnalisé pour ASP.NET 1.1Génération d'applications Web ASP.NET dans Visual Studio
Développement de contrôles serveur Web liés aux données personnalisés pour ASP.NET 1.1Génération d'applications Web ASP.NET dans Visual Studio
Développement de contrôles serveur Web liés aux données personnalisés pour ASP.NET 2.0Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'un contrôle Web ASP.NET lié aux données personnalisé pour ASP.NET 2.0Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'un contrôle Web ASP.NET lié aux données personnalisé pour ASP.NET 1.1Génération d'applications Web ASP.NET dans Visual Studio
Procédure pas à pas : création d'un contrôle Web ASP.NET lié aux données personnalisé pour ASP.NET 2.0Génération d'applications Web ASP.NET dans Visual Studio

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();

}

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft