Classe ChtmlTextWriter

Nota: questa classe è stata introdotta con .NET Framework versione 2.0.

Scrive una serie di caratteri e testo specifici di cHTML nel flusso di output per un controllo server ASP.NET. La classe ChtmlTextWriter fornisce le funzionalità di formattazione utilizzate dai controlli server di ASP.NET per il rendering del contenuto cHTML sui client.

Spazio dei nomi: System.Web.UI
Assembly: System.Web (in system.web.dll)

public class ChtmlTextWriter : Html32TextWriter
public class ChtmlTextWriter extends Html32TextWriter
public class ChtmlTextWriter extends Html32TextWriter

Compact HTML, o cHTML, è un sottoinsieme di HTML 2.0, HTML 3.2 e HTML 4.0 ed è progettato per eseguire il rendering su dispositivi con memoria e potenza di CPU limitate, oltre a schermi di piccole dimensioni, funzionalità di formattazione limitate e un numero ridotto di opzioni di input, ad esempio il touch pad di un telefono cellulare. In cHTML non sono quindi supportati gli elementi seguenti:

  • Immagini JPEG.

  • Tabelle.

  • Mappe immagine.

  • Più stili e tipi di carattere.

  • Colori e immagini di sfondo.

  • Frame.

  • Fogli di stile.

La classe ChtmlTextWriter deriva dalla classe Html32TextWriter e la maggior parte della funzionalità di questa classe deriva dalla classe Html32TextWriter e dalla classe base per tutti i writer di codice, ovvero la classe HtmlTextWriter.

Nell'esempio di codice riportato di seguito viene illustrato come creare una classe denominata CustomChtmlTextWriter derivata dalla classe ChtmlTextWriter. Vengono creati due costruttori e viene eseguito l'override del metodo OnAttributeRender per prevenire la scrittura dell'attributo di stile bgcolor nel flusso di output dell'oggetto ChtmlTextWriter. Viene inoltre creata una classe denominata ChtmlCustomPageAdapter che definisce un metodo, CreateCustomChtmlTextWriter, che crea e restituisce un'istanza della classe CustomChtmlTextWriter. CustomChtmlTextWriter esegue quindi il rendering di contenuto cHTML per una pagina in dispositivi con browser che utilizzano codice cHTML.

// Create a class that derives from the
// ChtmlTextWriter class.
using System;
using System.IO;
using System.Web.UI;
using System.Web.UI.WebControls.Adapters;

namespace AspNet.Samples.CS
{
	public class CustomChtmlTextWriter : ChtmlTextWriter
	{
		// Create two constructors for the new
		// text writer.
		public CustomChtmlTextWriter(TextWriter writer) : base(writer, DefaultTabString)
		{
		}

		public CustomChtmlTextWriter(TextWriter writer, String tabString)
			: base(writer, tabString)
		{
		}
		
		// Override the OnAttributeRender method to
		// not render the bgcolor attribute, which is
		// not supported in CHTML.
		protected override bool OnAttributeRender(string name, string value, HtmlTextWriterAttribute key)
		{
			if (String.Equals("bgcolor", name))
			{
				return false;
			}
			
			// Call the ChtmlTextWriter version of the
			// the OnAttributeRender method.
			return base.OnAttributeRender(name, value, key);
		}
	}

	// Derive from the WebControlAdapter class,
	// provide a CreateCustomChtmlTextWriter
	// method to attach to the custom writer.
	public class ChtmlCustomPageAdapter : WebControlAdapter
	{
		protected internal ChtmlTextWriter CreateCustomChtmlTextWriter(
			TextWriter writer)
		{
			return new CustomChtmlTextWriter(writer);
		}
	}
}

  • AspNetHostingPermission  per operare in un ambiente host. Valore richiesta: LinkDemand. Valore autorizzazione: Minimal.
  • AspNetHostingPermission  per operare in un ambiente host. Valore richiesta: InheritanceDemand. Valore autorizzazione: Minimal.

System.Object
   System.MarshalByRefObject
     System.IO.TextWriter
       System.Web.UI.HtmlTextWriter
         System.Web.UI.Html32TextWriter
          System.Web.UI.ChtmlTextWriter

I membri statici pubblici (Shared in Visual Basic) di questo tipo sono validi per le operazioni multithreading. I membri di istanza non sono garantiti come thread safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

.NET Framework

Supportato in: 2.0

Aggiunte alla community

AGGIUNGI
Mostra: