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.
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)
Public Class HtmlTextWriter _ Inherits TextWriter
public class HtmlTextWriter : TextWriter
public ref class HtmlTextWriter : public TextWriter
type HtmlTextWriter = class inherit TextWriter end
Il tipo HtmlTextWriter espone i seguenti membri.
| Nome | Descrizione | |
|---|---|---|
|
HtmlTextWriter(TextWriter) | Inizializza una nuova istanza della classe HtmlTextWriter che utilizza una stringa di tabulazioni predefinita. |
|
HtmlTextWriter(TextWriter, String) | Inizializza una nuova istanza della classe HtmlTextWriter con un carattere di stringa di tabulazioni specificato. |
| Nome | Descrizione | |
|---|---|---|
|
Encoding | Ottiene la codifica utilizzata dall'oggetto HtmlTextWriter per scrivere il contenuto nella pagina. (Esegue l'override di TextWriter.Encoding). |
|
FormatProvider | Recupera un oggetto che controlla la formattazione. (Ereditato da TextWriter) |
|
Indent | Ottiene o imposta il numero di posizioni di tabulazione per il rientro dell'inizio di ogni riga di markup. |
|
InnerWriter | Ottiene o imposta il writer di testo che scrive il contenuto interno dell'elemento di markup. |
|
NewLine | Ottiene o imposta la stringa del terminatore di riga utilizzata dall'oggetto HtmlTextWriter. (Esegue l'override di TextWriter.NewLine). |
|
TagKey | Ottiene o imposta il valore di HtmlTextWriterTag per l'elemento di markup specificato. |
|
TagName | Ottiene o imposta il nome del tag dell'elemento di markup di cui eseguire il rendering. |
| Nome | Descrizione | |
|---|---|---|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
BeginRender | Notifica a un oggetto HtmlTextWriter o a un oggetto di una classe derivata che si sta per eseguire il rendering di un controllo. |
|
Close | Chiude l'oggetto HtmlTextWriter e rilascia tutte le risorse di sistema a esso associate. (Esegue l'override di TextWriter.Close()). |
|
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) |
|
Dispose() | Rilascia tutte le risorse utilizzate dall'oggetto TextWriter. (Ereditato da TextWriter) |
|
Dispose(Boolean) | Rilascia le risorse non gestite utilizzate dall'oggetto TextWriter ed eventualmente rilascia le risorse gestite. (Ereditato da TextWriter) |
|
EncodeAttributeValue(HtmlTextWriterAttribute, String) | Codifica il valore dell'attributo di markup specificato in base ai requisiti dell'oggetto HttpRequest del contesto corrente. |
|
EncodeAttributeValue(String, Boolean) | Codifica il valore dell'attributo di markup specificato in base ai requisiti dell'oggetto HttpRequest del contesto corrente. |
|
EncodeUrl | Esegue una codifica URL minima convertendo nella stringa "%20" gli spazi presenti nell'URL specificato. |
|
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. |
|
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. |
|
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. |
|
Equals(Object) | Determina se l'oggetto Object specificato è uguale all'oggetto Object corrente. (Ereditato da Object) |
|
ExitStyle(Style) | Scrive il tag di chiusura di un elemento <span> per terminare il layout e la formattazione dei caratteri specificati. |
|
ExitStyle(Style, HtmlTextWriterTag) | Scrive il tag di chiusura dell'elemento di markup specificato per terminare il layout e la formattazione dei caratteri specificati. |
|
FilterAttributes | Rimuove tutti gli attributi markup e di stile su tutte le proprietà della pagina o del controllo server Web. |
|
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) |
|
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()). |
|
GetAttributeKey | Ottiene il valore di enumerazione HtmlTextWriterAttribute corrispondente per l'attributo specificato. |
|
GetAttributeName | Ottiene il nome dell'attributo di markup associato al valore HtmlTextWriterAttribute specificato. |
|
GetHashCode | Funge da funzione hash per un determinato tipo. (Ereditato da Object) |
|
GetLifetimeService | Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject) |
|
GetStyleKey | Ottiene il valore di enumerazione HtmlTextWriterStyle per lo stile specificato. |
|
GetStyleName | Ottiene il nome dell'attributo di stile markup associato al valore di enumerazione HtmlTextWriterStyle specificato. |
|
GetTagKey | Ottiene il valore di enumerazione di HtmlTextWriterTag associato all'elemento di markup specificato. |
|
GetTagName | Ottiene l'elemento di markup associato al valore di enumerazione di HtmlTextWriterTag specificato. |
|
GetType | Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
|
InitializeLifetimeService | Consente di ottenere un oggetto servizio di durata per il controllo dei criteri di durata per l'istanza. (Ereditato da MarshalByRefObject) |
|
IsAttributeDefined(HtmlTextWriterAttribute) | Determina se viene eseguito il rendering dell'attributo di markup specificato e del relativo valore durante la chiamata successiva del metodo RenderBeginTag. |
|
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. |
|
IsStyleAttributeDefined(HtmlTextWriterStyle) | Determina se viene eseguito il rendering dell'attributo di stile markup specificato durante la chiamata successiva del metodo RenderBeginTag. |
|
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. |
|
IsValidFormAttribute | Controlla un attributo per assicurare che sia possibile eseguirne il rendering nel tag di apertura di un elemento di markup <form>. |
|
MemberwiseClone() | Consente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object) |
|
MemberwiseClone(Boolean) | Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject) |
|
OnAttributeRender | Determina se è possibile eseguire il rendering dell'attributo di markup specificato e del relativo valore nell'elemento di markup corrente. |
|
OnStyleAttributeRender | Determina se è possibile eseguire il rendering dell'attributo di stile markup specificato e del relativo valore nell'elemento di markup corrente. |
|
OnTagRender | Determina se verrà eseguito il rendering dell'elemento di markup specificato nella pagina richiedente. |
|
OutputTabs | Scrive una serie di stringhe di tabulazioni che rappresentano il livello di rientro di una riga di caratteri di markup. |
|
PopEndTag | Rimuove l'elemento di markup salvato più di recente dall'elenco degli elementi di cui è stato eseguito il rendering. |
|
PushEndTag | Salva l'elemento di markup specificato affinché venga utilizzato in seguito per la generazione del tag di fine per un elemento di markup. |
|
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. |
|
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. |
|
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. |
|
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. |
|
RenderAfterTag | Scrive qualsiasi spaziatura o testo presente dopo il tag di chiusura per un elemento di markup. |
|
RenderBeforeContent | Scrive qualsiasi testo o spaziatura prima del contenuto e dopo il tag di apertura di un elemento di markup. |
|
RenderBeforeTag | Scrive qualsiasi testo o spaziatura presente prima del tag di apertura di un elemento di markup. |
|
RenderBeginTag(HtmlTextWriterTag) | Scrive il tag di apertura dell'elemento di markup associato al valore di enumerazione di HtmlTextWriterTag specificato nel flusso di output. |
|
RenderBeginTag(String) | Scrive il tag di apertura dell'elemento di markup specificato nel flusso di output. |
|
RenderEndTag | Scrive il tag di fine di un elemento di markup nel flusso di output. |
|
ToString | Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
|
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)). |
|
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)). |
|
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[])). |
|
Write(Decimal) | Scrive nel flusso di testo la rappresentazione testuale di un valore decimale. (Ereditato da TextWriter) |
|
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)). |
|
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)). |
|
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)). |
|
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)). |
|
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)). |
|
Write(String) | Scrive nel flusso di output la stringa specificata e qualsiasi spaziatura di tabulazione in sospeso. (Esegue l'override di TextWriter.Write(String)). |
|
Write(UInt32) | Scrive nel flusso di testo la rappresentazione testuale di un intero senza segno a 4 byte. (Ereditato da TextWriter) |
|
Write(UInt64) | Scrive nel flusso di testo la rappresentazione testuale di un intero senza segno a 8 byte. (Ereditato da TextWriter) |
|
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)). |
|
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[])). |
|
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)). |
|
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)). |
|
Write(String, Object, Object, Object) | Scrive una stringa formattata utilizzando la stessa semantica di String.Format. (Ereditato da TextWriter) |
|
WriteAttribute(String, String) | Scrive l'attributo di markup specificato e il relativo valore nel flusso di output. |
|
WriteAttribute(String, String, Boolean) | Scrive l'attributo di markup e il valore specificati nel flusso di output e, se specificato, scrive il valore codificato. |
|
WriteBeginTag | Scrive l'eventuale spaziatura di tabulazione e il tag di apertura dell'elemento di markup specificato nel flusso di output. |
|
WriteBreak | Scrive un elemento di markup <br /> nel flusso di output. |
|
WriteEncodedText | Codifica il testo specificato per la periferica richiedente, quindi lo scrive nel flusso di output. |
|
WriteEncodedUrl | Codifica l'URL specificato e lo scrive nel flusso di output. L'URL può includere parametri. |
|
WriteEncodedUrlParameter | Codifica il parametro URL specificato per la periferica richiedente, quindi lo scrive nel flusso di output. |
|
WriteEndTag | Scrive l'eventuale spaziatura di tabulazione e il tag di chiusura dell'elemento di markup specificato. |
|
WriteFullBeginTag | Scrive l'eventuale spaziatura di tabulazione e il tag di apertura dell'elemento di markup specificato nel flusso di output. |
|
WriteLine() | Scrive un terminatore di riga nel flusso di output. (Esegue l'override di TextWriter.WriteLine()). |
|
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)). |
|
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)). |
|
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[])). |
|
WriteLine(Decimal) | Scrive nel flusso di testo la rappresentazione testuale di un valore decimale, seguita da un terminatore di riga. (Ereditato da TextWriter) |
|
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)). |
|
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)). |
|
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)). |
|
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)). |
|
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)). |
|
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)). |
|
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)). |
|
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) |
|
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)). |
|
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[])). |
|
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)). |
|
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)). |
|
WriteLine(String, Object, Object, Object) | Scrive una stringa formattata e una nuova riga utilizzando la stessa semantica di Format. (Ereditato da TextWriter) |
|
WriteLineNoTabs | Scrive una stringa, seguita da una stringa del terminatore di riga, nel flusso di output. Questo metodo ignora qualsiasi spaziatura di tabulazione specificata. |
|
WriteStyleAttribute(String, String) | Scrive l'attributo di stile specificato nel flusso di output. |
|
WriteStyleAttribute(String, String, Boolean) | Scrive l'attributo di stile e il valore specificati nel flusso di output e codifica il valore, se specificato. |
|
WriteUrlEncodedString | Scrive la stringa specificata, codificandola secondo i requisiti URL. |
| Nome | Descrizione | |
|---|---|---|
|
CoreNewLine | Archivia i caratteri di nuova riga utilizzati per questo TextWriter. (Ereditato da TextWriter) |
|
DefaultTabString | Rappresenta un singolo carattere di tabulazione. |
|
DoubleQuoteChar | Rappresenta il carattere virgolette doppie ("). |
|
EndTagLeftChars | Rappresenta la parentesi angolare di apertura e la barra (</) del tag di chiusura di un elemento di markup. |
|
EqualsChar | Rappresenta il segno di uguale (=). |
|
EqualsDoubleQuoteString | Rappresenta un segno di uguale (=) e un segno di virgolette doppie (") insieme in una stringa (="). |
|
SelfClosingChars | Rappresenta uno spazio e la barra di autochiusura (/) di un tag del markup. |
|
SelfClosingTagEnd | Rappresenta la barra di chiusura e la parentesi angolare di chiusura (/>) di un elemento di markup con autochiusura. |
|
SemicolonChar | Rappresenta il punto e virgola (;). |
|
SingleQuoteChar | Rappresenta un apostrofo ('). |
|
SlashChar | Rappresenta la barra (/). |
|
SpaceChar | Rappresenta uno spazio ( ). |
|
StyleEqualsChar | Rappresenta il carattere (:) di stile utilizzato per impostare attributi di stile corrispondenti ai valori. |
|
TagLeftChar | Rappresenta la parentesi angolare di apertura (<) di un tag del markup. |
|
TagRightChar | Rappresenta la parentesi angolare di chiusura (>) di un tag del markup. |
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.
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.
' 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 "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 -= 1 writer.RenderEndTag() End Sub 'Render
// 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();
}
.NET Framework
Supportato in: 4, 3.5, 3.0, 2.0, 1.1, 1.0Windows 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.