HtmlTextWriter (Clase)
Ensamblado: System.Web (en system.web.dll)
La clase HtmlTextWriter se usa para representar HTML 4.0 en exploradores de escritorio. La clase HtmlTextWriter es también la clase base para todos los sistemas de escritura de marcado del espacio de nombres System.Web.UI, incluidas las clases ChtmlTextWriter, Html32TextWriter y XhtmlTextWriter. Estas clases se usan para escribir los elementos, atributos y la información de estilo y diseño de los distintos tipos de marcado. Además, estas las clases de adaptación de página y de control asociadas a cada lenguaje de marcado usan estas clases.
En la mayor parte de los casos, ASP.NET usa automáticamente el sistema de escritura apropiado para el dispositivo que realiza la solicitud. Sin embargo, si crea un escritor de texto personalizado o desea especificar un escritor concreto para representar una página para un dispositivo concreto, debe asignar el sistema de escritura a la página en la sección controlAdapters del archivo .browser de la aplicación.
En el siguiente ejemplo de código se muestra cómo se reemplaza el método Render de un control personalizado derivado de la clase Control. En el ejemplo siguiente, se muestra cómo se utilizan diversos métodos, propiedades y campos de la clase 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 "encoding " 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(); }
Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter
Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.