Classe HtmlTextWriter (System.Web.UI)

Cambia visualizzazione:
ScriptFree
Riferimento a .NET Framework
Classe HtmlTextWriter
Il presente articolo è stato tradotto manualmente. Per visualizzare questa pagina e contemporaneamente visualizzarne il contenuto in lingua inglese, passare alla visualizzazione semplificata.

Scrive caratteri di markup e testo in un flusso di output di un controllo server ASP.NET. Questa classe fornisce le funzionalità di formattazione utilizzate dai controlli server ASP.NET per il rendering di markup sui client.

Gerarchia di ereditarietà

System.Object
  System.MarshalByRefObject
    System.IO.TextWriter
      System.Web.UI.HtmlTextWriter
        System.Web.UI.Html32TextWriter
        System.Web.UI.MobileControls.Adapters.MultiPartWriter
        System.Web.UI.XhtmlTextWriter

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

Visual Basic
Public Class HtmlTextWriter _
	Inherits TextWriter
C#
public class HtmlTextWriter : TextWriter
Visual C++
public ref class HtmlTextWriter : public TextWriter
F#
type HtmlTextWriter =  
    class
        inherit TextWriter
    end

Il tipo HtmlTextWriter espone i seguenti membri.

Costruttori

  Nome Descrizione
Metodo pubblico HtmlTextWriter(TextWriter) Inizializza una nuova istanza della classe HtmlTextWriter che utilizza una stringa di tabulazioni predefinita.
Metodo pubblico HtmlTextWriter(TextWriter, String) Inizializza una nuova istanza della classe HtmlTextWriter con un carattere di stringa di tabulazioni specificato.
In alto
Proprietà

  Nome Descrizione
Proprietà pubblica Encoding Ottiene la codifica utilizzata dall'oggetto HtmlTextWriter per scrivere il contenuto nella pagina. (Esegue l'override di TextWriter.Encoding).
Proprietà pubblica FormatProvider Recupera un oggetto che controlla la formattazione. (Ereditato da TextWriter)
Proprietà pubblica Indent Ottiene o imposta il numero di posizioni di tabulazione per il rientro dell'inizio di ogni riga di markup.
Proprietà pubblica InnerWriter Ottiene o imposta il writer di testo che scrive il contenuto interno dell'elemento di markup.
Proprietà pubblica NewLine Ottiene o imposta la stringa del terminatore di riga utilizzata dall'oggetto HtmlTextWriter. (Esegue l'override di TextWriter.NewLine).
Proprietà protetta. TagKey Ottiene o imposta il valore di HtmlTextWriterTag per l'elemento di markup specificato.
Proprietà protetta. TagName Ottiene o imposta il nome del tag dell'elemento di markup di cui eseguire il rendering.
In alto
Metodi

  Nome Descrizione
Metodo pubblico AddAttribute(HtmlTextWriterAttribute, String) Aggiunge l'attributo di markup e il valore dell'attributo al tag di apertura dell'elemento creato dall'oggetto HtmlTextWriter con una chiamata successiva al metodo RenderBeginTag.
Metodo pubblico AddAttribute(String, String) Aggiunge il valore e l'attributo di markup specificato al tag di apertura dell'elemento creato dall'oggetto HtmlTextWriter con una chiamata successiva al metodo RenderBeginTag.
Metodo pubblico AddAttribute(HtmlTextWriterAttribute, String, Boolean) Aggiunge l'attributo di markup e il valore dell'attributo al tag di apertura dell'elemento creato dall'oggetto HtmlTextWriter con una chiamata successiva del metodo RenderBeginTag, con codifica facoltativa.
Metodo pubblico AddAttribute(String, String, Boolean) Aggiunge il valore e l'attributo di markup specificato al tag di apertura dell'elemento creato dall'oggetto HtmlTextWriter con una chiamata successiva del metodo RenderBeginTag, con codifica aggiuntiva.
Metodo protetto AddAttribute(String, String, HtmlTextWriterAttribute) Aggiunge il valore e l'attributo di markup specificato, oltre a un valore di enumerazione HtmlTextWriterAttribute, al tag di apertura dell'elemento creato dall'oggetto HtmlTextWriter con una chiamata successiva del metodo RenderBeginTag.
Metodo pubblico AddStyleAttribute(HtmlTextWriterStyle, String) Aggiunge l'attributo di stile markup associato al valore HtmlTextWriterStyle specificato e il valore dell'attributo al tag del markup di apertura creato da una chiamata successiva del metodo RenderBeginTag.
Metodo pubblico AddStyleAttribute(String, String) Aggiunge l'attributo di stile del markup specificato e il valore dell'attributo al tag del markup di apertura creato da una chiamata successiva del metodo RenderBeginTag.
Metodo protetto AddStyleAttribute(String, String, HtmlTextWriterStyle) Aggiunge l'attributo di stile del markup specificato e il valore dell'attributo, oltre a un valore di enumerazione HtmlTextWriterStyle, al markup di apertura creato da una chiamata successiva del metodo RenderBeginTag.
Metodo pubblico BeginRender Notifica a un oggetto HtmlTextWriter o a un oggetto di una classe derivata che si sta per eseguire il rendering di un controllo.
Metodo pubblico Close Chiude l'oggetto HtmlTextWriter e rilascia tutte le risorse di sistema a esso associate. (Esegue l'override di TextWriter.Close()).
Metodo pubblico CreateObjRef Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto. (Ereditato da MarshalByRefObject)
Metodo pubblico Dispose() Rilascia tutte le risorse utilizzate dall'oggetto TextWriter. (Ereditato da TextWriter)
Metodo protetto Dispose(Boolean) Rilascia le risorse non gestite utilizzate dall'oggetto TextWriter ed eventualmente rilascia le risorse gestite. (Ereditato da TextWriter)
Metodo protetto EncodeAttributeValue(HtmlTextWriterAttribute, String) Codifica il valore dell'attributo di markup specificato in base ai requisiti dell'oggetto HttpRequest del contesto corrente.
Metodo protetto EncodeAttributeValue(String, Boolean) Codifica il valore dell'attributo di markup specificato in base ai requisiti dell'oggetto HttpRequest del contesto corrente.
Metodo protetto EncodeUrl Esegue una codifica URL minima convertendo nella stringa "%20" gli spazi presenti nell'URL specificato.
Metodo pubblico EndRender Notifica a un oggetto HtmlTextWriter o a un oggetto di una classe derivata che un il rendering di un controllo è completato. È possibile utilizzare questo metodo per chiudere gli elementi markup aperti nel metodo BeginRender.
Metodo pubblico EnterStyle(Style) Scrive il tag di apertura di un elemento <span> contenente attributi che implementano il layout e la formattazione dei caratteri dello stile specificato.
Metodo pubblico EnterStyle(Style, HtmlTextWriterTag) Scrive il tag di apertura di un elemento di markup contenente attributi che implementano il layout e la formattazione dei caratteri dello stile specificato.
Metodo pubblico Equals(Object) Determina se l'oggetto Object specificato è uguale all'oggetto Object corrente. (Ereditato da Object)
Metodo pubblico ExitStyle(Style) Scrive il tag di chiusura di un elemento <span> per terminare il layout e la formattazione dei caratteri specificati.
Metodo pubblico ExitStyle(Style, HtmlTextWriterTag) Scrive il tag di chiusura dell'elemento di markup specificato per terminare il layout e la formattazione dei caratteri specificati.
Metodo protetto FilterAttributes Rimuove tutti gli attributi markup e di stile su tutte le proprietà della pagina o del controllo server Web.
Metodo protetto Finalize Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulitura prima che l'oggetto stesso venga recuperato dalla procedura di Garbage Collection. (Ereditato da Object)
Metodo pubblico Flush Cancella tutti i buffer per l'oggetto HtmlTextWriter corrente e consente la scrittura nel flusso di output dei dati memorizzati nel buffer. (Esegue l'override di TextWriter.Flush()).
Metodo protetto GetAttributeKey Ottiene il valore di enumerazione HtmlTextWriterAttribute corrispondente per l'attributo specificato.
Metodo protetto GetAttributeName Ottiene il nome dell'attributo di markup associato al valore HtmlTextWriterAttribute specificato.
Metodo pubblico GetHashCode Funge da funzione hash per un determinato tipo. (Ereditato da Object)
Metodo pubblico GetLifetimeService Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
Metodo protetto GetStyleKey Ottiene il valore di enumerazione HtmlTextWriterStyle per lo stile specificato.
Metodo protetto GetStyleName Ottiene il nome dell'attributo di stile markup associato al valore di enumerazione HtmlTextWriterStyle specificato.
Metodo protetto GetTagKey Ottiene il valore di enumerazione di HtmlTextWriterTag associato all'elemento di markup specificato.
Metodo protetto GetTagName Ottiene l'elemento di markup associato al valore di enumerazione di HtmlTextWriterTag specificato.
Metodo pubblico GetType Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Metodo pubblico InitializeLifetimeService Consente di ottenere un oggetto servizio di durata per il controllo dei criteri di durata per l'istanza. (Ereditato da MarshalByRefObject)
Metodo protetto IsAttributeDefined(HtmlTextWriterAttribute) Determina se viene eseguito il rendering dell'attributo di markup specificato e del relativo valore durante la chiamata successiva del metodo RenderBeginTag.
Metodo protetto IsAttributeDefined(HtmlTextWriterAttribute, String) Determina se viene eseguito il rendering dell'attributo di markup specificato e del relativo valore durante la chiamata successiva del metodo RenderBeginTag.
Metodo protetto IsStyleAttributeDefined(HtmlTextWriterStyle) Determina se viene eseguito il rendering dell'attributo di stile markup specificato durante la chiamata successiva del metodo RenderBeginTag.
Metodo protetto IsStyleAttributeDefined(HtmlTextWriterStyle, String) Determina se viene eseguito il rendering dell'attributo di stile markup specificato e del relativo valore durante la chiamata successiva del metodo RenderBeginTag.
Metodo pubblico IsValidFormAttribute Controlla un attributo per assicurare che sia possibile eseguirne il rendering nel tag di apertura di un elemento di markup <form>.
Metodo protetto MemberwiseClone() Consente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
Metodo protetto MemberwiseClone(Boolean) Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
Metodo protetto OnAttributeRender Determina se è possibile eseguire il rendering dell'attributo di markup specificato e del relativo valore nell'elemento di markup corrente.
Metodo protetto OnStyleAttributeRender Determina se è possibile eseguire il rendering dell'attributo di stile markup specificato e del relativo valore nell'elemento di markup corrente.
Metodo protetto OnTagRender Determina se verrà eseguito il rendering dell'elemento di markup specificato nella pagina richiedente.
Metodo protetto OutputTabs Scrive una serie di stringhe di tabulazioni che rappresentano il livello di rientro di una riga di caratteri di markup.
Metodo protetto PopEndTag Rimuove l'elemento di markup salvato più di recente dall'elenco degli elementi di cui è stato eseguito il rendering.
Metodo protetto PushEndTag Salva l'elemento di markup specificato affinché venga utilizzato in seguito per la generazione del tag di fine per un elemento di markup.
Metodo protetto Membro statico RegisterAttribute Registra gli attributi markup, che si tratti di valori letterali o di attributi generati in modo dinamico, dal file di origine affinché sia possibile eseguirne correttamente il rendering sul client richiedente.
Metodo protetto Membro statico RegisterStyle Registra le proprietà di stile markup, che si tratti di valori letterali o attributi generati in modo dinamico, dal file di origine in modo che sia possibile eseguirne correttamente il rendering sul client richiedente.
Metodo protetto Membro statico RegisterTag Registra i tag del markup, che si tratti di valori letterali o di attributi generati in modo dinamico, dal file di origine in modo che sia possibile eseguirne correttamente il rendering sul client richiedente.
Metodo protetto RenderAfterContent Scrive qualsiasi testo o spaziatura presente dopo il contenuto e prima del tag di chiusura dell'elemento di markup nel flusso di output del markup.
Metodo protetto RenderAfterTag Scrive qualsiasi spaziatura o testo presente dopo il tag di chiusura per un elemento di markup.
Metodo protetto RenderBeforeContent Scrive qualsiasi testo o spaziatura prima del contenuto e dopo il tag di apertura di un elemento di markup.
Metodo protetto RenderBeforeTag Scrive qualsiasi testo o spaziatura presente prima del tag di apertura di un elemento di markup.
Metodo pubblico RenderBeginTag(HtmlTextWriterTag) Scrive il tag di apertura dell'elemento di markup associato al valore di enumerazione di HtmlTextWriterTag specificato nel flusso di output.
Metodo pubblico RenderBeginTag(String) Scrive il tag di apertura dell'elemento di markup specificato nel flusso di output.
Metodo pubblico RenderEndTag Scrive il tag di fine di un elemento di markup nel flusso di output.
Metodo pubblico ToString Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Metodo pubblico Write(Boolean) Scrive la rappresentazione testuale di un valore Boolean nel flusso di output, insieme a qualsiasi spaziatura di tabulazione in sospeso. (Esegue l'override di TextWriter.Write(Boolean)).
Metodo pubblico Write(Char) Scrive la rappresentazione testuale di un carattere Unicode nel flusso di output, insieme a qualsiasi spaziatura di tabulazione in sospeso. (Esegue l'override di TextWriter.Write(Char)).
Metodo pubblico Write(Char[]) Scrive la rappresentazione testuale di una matrice di caratteri Unicode nel flusso di output, insieme a qualsiasi spaziatura di tabulazione in sospeso. (Esegue l'override di TextWriter.Write(Char[])).
Metodo pubblico Write(Decimal) Scrive nel flusso di testo la rappresentazione testuale di un valore decimale. (Ereditato da TextWriter)
Metodo pubblico Write(Double) Scrive nel flusso di output la rappresentazione testuale di un numero in virgola mobile e precisione doppia e qualsiasi spaziatura di tabulazione in sospeso. (Esegue l'override di TextWriter.Write(Double)).
Metodo pubblico Write(Int32) Scrive nel flusso di output la rappresentazione testuale di un intero con segno a 32 byte e qualsiasi spaziatura di tabulazione in sospeso. (Esegue l'override di TextWriter.Write(Int32)).
Metodo pubblico Write(Int64) Scrive nel flusso di testo la rappresentazione testuale di un valore integer a 64 byte con segno e qualsiasi spaziatura di tabulazione in sospeso. (Esegue l'override di TextWriter.Write(Int64)).
Metodo pubblico Write(Object) Scrive nel flusso di output la rappresentazione testuale di un oggetto e qualsiasi spaziatura di tabulazione in sospeso. (Esegue l'override di TextWriter.Write(Object)).
Metodo pubblico Write(Single) Scrive nel flusso di output la rappresentazione testuale di un numero in virgola mobile e precisione singola e qualsiasi spaziatura di tabulazione in sospeso. (Esegue l'override di TextWriter.Write(Single)).
Metodo pubblico Write(String) Scrive nel flusso di output la stringa specificata e qualsiasi spaziatura di tabulazione in sospeso. (Esegue l'override di TextWriter.Write(String)).
Metodo pubblico Write(UInt32) Scrive nel flusso di testo la rappresentazione testuale di un intero senza segno a 4 byte. (Ereditato da TextWriter)
Metodo pubblico Write(UInt64) Scrive nel flusso di testo la rappresentazione testuale di un intero senza segno a 8 byte. (Ereditato da TextWriter)
Metodo pubblico Write(String, Object) Scrive nel flusso di output una stringa di tabulazioni e una stringa formattata utilizzando la stessa semantica del metodo String.Format, insieme a qualsiasi spaziatura di tabulazione in sospeso. (Esegue l'override di TextWriter.Write(String, Object)).
Metodo pubblico Write(String, Object[]) Scrive una stringa formattata contenente la rappresentazione testuale di una matrice di oggetti nel flusso di output, insieme a qualsiasi spaziatura di tabulazione in sospeso. Il metodo utilizza la stessa semantica del metodo String.Format. (Esegue l'override di TextWriter.Write(String, Object[])).
Metodo pubblico Write(Char[], Int32, Int32) Scrive la rappresentazione testuale di una sottomatrice di caratteri Unicode nel flusso di output, insieme a qualsiasi spaziatura di tabulazione in sospeso. (Esegue l'override di TextWriter.Write(Char[], Int32, Int32)).
Metodo pubblico Write(String, Object, Object) Scrive una stringa formattata contenente la rappresentazione testuale di due oggetti nel flusso di output, insieme a qualsiasi spaziatura di tabulazione in sospeso. Il metodo utilizza la stessa semantica del metodo String.Format. (Esegue l'override di TextWriter.Write(String, Object, Object)).
Metodo pubblico Write(String, Object, Object, Object) Scrive una stringa formattata utilizzando la stessa semantica di String.Format. (Ereditato da TextWriter)
Metodo pubblico WriteAttribute(String, String) Scrive l'attributo di markup specificato e il relativo valore nel flusso di output.
Metodo pubblico WriteAttribute(String, String, Boolean) Scrive l'attributo di markup e il valore specificati nel flusso di output e, se specificato, scrive il valore codificato.
Metodo pubblico WriteBeginTag Scrive l'eventuale spaziatura di tabulazione e il tag di apertura dell'elemento di markup specificato nel flusso di output.
Metodo pubblico WriteBreak Scrive un elemento di markup <br /> nel flusso di output.
Metodo pubblico WriteEncodedText Codifica il testo specificato per la periferica richiedente, quindi lo scrive nel flusso di output.
Metodo pubblico WriteEncodedUrl Codifica l'URL specificato e lo scrive nel flusso di output. L'URL può includere parametri.
Metodo pubblico WriteEncodedUrlParameter Codifica il parametro URL specificato per la periferica richiedente, quindi lo scrive nel flusso di output.
Metodo pubblico WriteEndTag Scrive l'eventuale spaziatura di tabulazione e il tag di chiusura dell'elemento di markup specificato.
Metodo pubblico WriteFullBeginTag Scrive l'eventuale spaziatura di tabulazione e il tag di apertura dell'elemento di markup specificato nel flusso di output.
Metodo pubblico WriteLine() Scrive un terminatore di riga nel flusso di output. (Esegue l'override di TextWriter.WriteLine()).
Metodo pubblico WriteLine(Boolean) Scrive qualsiasi spaziatura di tabulazione in sospeso e la rappresentazione testuale di un valore Boolean, seguita da una stringa del terminatore di riga nel flusso di output. (Esegue l'override di TextWriter.WriteLine(Boolean)).
Metodo pubblico WriteLine(Char) Scrive qualsiasi spaziatura di tabulazione in sospeso e un carattere Unicode, seguito da una stringa del terminatore di riga, nel flusso di output. (Esegue l'override di TextWriter.WriteLine(Char)).
Metodo pubblico WriteLine(Char[]) Scrive qualsiasi spaziatura di tabulazione in sospeso e una matrice di caratteri Unicode, seguita da una stringa del terminatore di riga, nel flusso di output. (Esegue l'override di TextWriter.WriteLine(Char[])).
Metodo pubblico WriteLine(Decimal) Scrive nel flusso di testo la rappresentazione testuale di un valore decimale, seguita da un terminatore di riga. (Ereditato da TextWriter)
Metodo pubblico WriteLine(Double) Scrive qualsiasi spaziatura di tabulazione in sospeso e la rappresentazione testuale di un numero in virgola mobile e precisione doppia, seguita da una stringa del terminatore di riga, nel flusso di output. (Esegue l'override di TextWriter.WriteLine(Double)).
Metodo pubblico WriteLine(Int32) Scrive qualsiasi spaziatura di tabulazione in sospeso e la rappresentazione testuale di un intero con segno a 32 byte, seguita da una stringa del terminatore di riga, nel flusso di output. (Esegue l'override di TextWriter.WriteLine(Int32)).
Metodo pubblico WriteLine(Int64) Scrive qualsiasi spaziatura di tabulazione in sospeso e la rappresentazione testuale di un valore integer con segno a 64 byte, seguita da una stringa del terminatore di riga, nel flusso di output. (Esegue l'override di TextWriter.WriteLine(Int64)).
Metodo pubblico WriteLine(Object) Scrive qualsiasi spaziatura di tabulazione in sospeso e la rappresentazione testuale di un oggetto, seguita da una stringa del terminatore di riga, nel flusso di output. (Esegue l'override di TextWriter.WriteLine(Object)).
Metodo pubblico WriteLine(Single) Scrive qualsiasi spaziatura di tabulazione in sospeso e la rappresentazione testuale di un numero in virgola mobile e precisione singola, seguita da una stringa del terminatore di riga, nel flusso di output. (Esegue l'override di TextWriter.WriteLine(Single)).
Metodo pubblico WriteLine(String) Scrive qualsiasi spaziatura di tabulazione in sospeso e una stringa di testo, seguita da una stringa del terminatore di riga, nel flusso di output. (Esegue l'override di TextWriter.WriteLine(String)).
Metodo pubblico WriteLine(UInt32) Scrive qualsiasi spaziatura di tabulazione in sospeso e la rappresentazione testuale di un valore integer a 4 byte senza segno, seguita da una stringa del terminatore di riga, nel flusso di output. (Esegue l'override di TextWriter.WriteLine(UInt32)).
Metodo pubblico WriteLine(UInt64) Scrive nel flusso di testo la rappresentazione testuale di un intero senza segno a 8 byte, seguito da un terminatore di riga. (Ereditato da TextWriter)
Metodo pubblico WriteLine(String, Object) Scrive qualsiasi spaziatura di tabulazione in sospeso e una stringa formattata contenente la rappresentazione testuale di un oggetto, seguita da una stringa del terminatore di riga, nel flusso di output. (Esegue l'override di TextWriter.WriteLine(String, Object)).
Metodo pubblico WriteLine(String, Object[]) Scrive qualsiasi spaziatura di tabulazione in sospeso e una stringa formattata contenente la rappresentazione testuale di una matrice di oggetti, seguita da una stringa del terminatore di riga, nel flusso di output. (Esegue l'override di TextWriter.WriteLine(String, Object[])).
Metodo pubblico WriteLine(Char[], Int32, Int32) Scrive qualsiasi spaziatura di tabulazione in sospeso e una sottomatrice di caratteri Unicode, seguita da una stringa del terminatore di riga, nel flusso di output. (Esegue l'override di TextWriter.WriteLine(Char[], Int32, Int32)).
Metodo pubblico WriteLine(String, Object, Object) Scrive qualsiasi spaziatura di tabulazione in sospeso e una stringa formattata contenente la rappresentazione testuale di due oggetti, seguita da una stringa del terminatore di riga, nel flusso di output. (Esegue l'override di TextWriter.WriteLine(String, Object, Object)).
Metodo pubblico WriteLine(String, Object, Object, Object) Scrive una stringa formattata e una nuova riga utilizzando la stessa semantica di Format. (Ereditato da TextWriter)
Metodo pubblico WriteLineNoTabs Scrive una stringa, seguita da una stringa del terminatore di riga, nel flusso di output. Questo metodo ignora qualsiasi spaziatura di tabulazione specificata.
Metodo pubblico WriteStyleAttribute(String, String) Scrive l'attributo di stile specificato nel flusso di output.
Metodo pubblico WriteStyleAttribute(String, String, Boolean) Scrive l'attributo di stile e il valore specificati nel flusso di output e codifica il valore, se specificato.
Metodo protetto WriteUrlEncodedString Scrive la stringa specificata, codificandola secondo i requisiti URL.
In alto
Campi

  Nome Descrizione
Campo protetto CoreNewLine Archivia i caratteri di nuova riga utilizzati per questo TextWriter. (Ereditato da TextWriter)
Campo pubblico Membro statico DefaultTabString Rappresenta un singolo carattere di tabulazione.
Campo pubblico Membro statico DoubleQuoteChar Rappresenta il carattere virgolette doppie (").
Campo pubblico Membro statico EndTagLeftChars Rappresenta la parentesi angolare di apertura e la barra (</) del tag di chiusura di un elemento di markup.
Campo pubblico Membro statico EqualsChar Rappresenta il segno di uguale (=).
Campo pubblico Membro statico EqualsDoubleQuoteString Rappresenta un segno di uguale (=) e un segno di virgolette doppie (") insieme in una stringa (=").
Campo pubblico Membro statico SelfClosingChars Rappresenta uno spazio e la barra di autochiusura (/) di un tag del markup.
Campo pubblico Membro statico SelfClosingTagEnd Rappresenta la barra di chiusura e la parentesi angolare di chiusura (/>) di un elemento di markup con autochiusura.
Campo pubblico Membro statico SemicolonChar Rappresenta il punto e virgola (;).
Campo pubblico Membro statico SingleQuoteChar Rappresenta un apostrofo (').
Campo pubblico Membro statico SlashChar Rappresenta la barra (/).
Campo pubblico Membro statico SpaceChar Rappresenta uno spazio ( ).
Campo pubblico Membro statico StyleEqualsChar Rappresenta il carattere (:) di stile utilizzato per impostare attributi di stile corrispondenti ai valori.
Campo pubblico Membro statico TagLeftChar Rappresenta la parentesi angolare di apertura (<) di un tag del markup.
Campo pubblico Membro statico TagRightChar Rappresenta la parentesi angolare di chiusura (>) di un tag del markup.
In alto
Note

Classe HtmlTextWriter utilizzata per il rendering di HTML 4.0 su browser desktop. HtmlTextWriter è anche la classe base per tutti i writer di markup nello spazio dei nomi System.Web.UI, incluse le classi ChtmlTextWriter, Html32TextWriter e XhtmlTextWriter. Queste classi sono utilizzate per scrivere gli elementi, gli attributi e le informazioni di stile e layout per i diversi tipi di markup. Inoltre, queste classi sono utilizzate dalle classi di adattatori di pagina e di controllo associate a ogni linguaggio markup.

Nella maggior parte dei casi, ASP.NET utilizza automaticamente il writer appropriato per la periferica richiedente. Tuttavia, se si crea un writer di testo personalizzato o si desidera specificare un writer particolare per eseguire il rendering di una pagina per una periferica specifica, è necessario eseguire il mapping del writer sulla pagina nella sezione controlAdapters del file browser dell'applicazione.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come eseguire l'override del metodo Render per un controllo personalizzato derivato dalla classe Control. Nell'esempio di codice viene illustrato come utilizzare vari campi, proprietà e metodi HtmlTextWriter.

Visual Basic

' Overrides the Render method to write a <span> element
' that applies styles and attributes.     
Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)

    ' 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 += 1

    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 -= 1
    writer.RenderEndTag()

End Sub 'Render


C#

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

        }


Informazioni sulla versione

.NET Framework

Supportato in: 4, 3.5, 3.0, 2.0, 1.1, 1.0
Piattaforme

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

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

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.
Vedere anche

Riferimenti