HtmlTextWriter.WriteBeginTag(String) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI
Assembly:
System.Web.dll

Scrive l'eventuale spaziatura di tabulazione e il tag di apertura dell'elemento di markup specificato nel flusso di output.

public:
 virtual void WriteBeginTag(System::String ^ tagName);
public virtual void WriteBeginTag (string tagName);
abstract member WriteBeginTag : string -> unit
override this.WriteBeginTag : string -> unit
Public Overridable Sub WriteBeginTag (tagName As String)

Parametri

tagName
String

Elemento di markup di cui scrivere il tag di apertura.

Esempio

Nell'esempio di codice seguente viene illustrato il rendering di un <img> elemento in cui vengono chiamati entrambi gli overload del WriteAttribute metodo. L'esempio di codice usa il processo seguente:

  • Chiama il metodo, che esegue il WriteBeginTag rendering dei caratteri di apertura dell'elemento.

  • Chiama l'overload WriteAttribute(String, String) , che scrive un alt attributo e il relativo valore nell'elemento <img> .

  • Chiama l'overload per eseguire il WriteAttribute(String, String, Boolean) rendering di un attributo personalizzato myattribute , con un valore di No "encoding" requirede quindi imposta fEncode su false.

  • Chiude il tag di apertura dell'elemento e quindi chiama il WriteEndTag metodo per chiudere l'elemento <img> .

Questo esempio di codice genera il markup seguente:

<img alt="AtlValue" myattribute="No &quot;encoding&quot; required">

</img>

// Create a manually rendered tag.
writer->WriteBeginTag( "img" );
writer->WriteAttribute( "alt", "AtlValue" );
writer->WriteAttribute( "myattribute", "No "encoding " required", false );
writer->Write( HtmlTextWriter::TagRightChar );
writer->WriteEndTag( "img" );

// Create a manually rendered tag.
writer.WriteBeginTag("img");
writer.WriteAttribute("alt", "AtlValue");
writer.WriteAttribute("myattribute", "No "encoding " required", false);
writer.Write(HtmlTextWriter.TagRightChar);
writer.WriteEndTag("img");

' Create a manually rendered tag.
writer.WriteBeginTag("img")
writer.WriteAttribute("alt", "AtlValue")
writer.WriteAttribute("myattribute", "No "encoding " required", False)
writer.Write(HtmlTextWriter.TagRightChar)

Commenti

Il WriteBeginTag metodo non scrive la parentesi angolare di chiusura (>) del tag di apertura dell'elemento di markup. Ciò consente la scrittura di attributi di markup nel tag di apertura dell'elemento. Utilizzare la costante per chiudere il TagRightChar tag di apertura quando si chiama il WriteBeginTag metodo . Usare il WriteBeginTag metodo con la SelfClosingTagEnd costante quando si scrivono elementi di markup che si chiudeno automaticamente.

Il WriteBeginTag metodo viene usato dai controlli server personalizzati che non consentono il mapping di tag o attributi e esegue il rendering degli elementi di markup nello stesso modo per ogni richiesta.

Si applica a

Vedi anche