HtmlTextWriter.RenderBeginTag Metodo

Definizione

Spazio dei nomi:

System.Web.UI

Assembly:

System.Web.dll

Scrive il tag di apertura di un elemento di markup nel flusso di output.

Overload

RenderBeginTag(String)	Scrive il tag di apertura dell'elemento di markup specificato nel flusso di output.
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.

public:
 virtual void RenderBeginTag(System::String ^ tagName);

public virtual void RenderBeginTag (string tagName);

abstract member RenderBeginTag : string -> unit
override this.RenderBeginTag : string -> unit

Public Overridable Sub RenderBeginTag (tagName As String)

Parametri

tagName

String

Stringa contenente il nome dell'elemento di markup per il quale eseguire il rendering del tag di apertura.

Esempio

Nell'esempio di codice seguente viene illustrato come chiamare il metodo in un controllo personalizzato per eseguire il RenderBeginTag rendering del tag di apertura di un elemento non standard MyTag . L'esempio di codice chiama quindi il metodo per eseguire il Write rendering del markup interno e quindi chiama il metodo per chiudere l'elemento RenderEndTag .

Questo esempio di codice genera il markup seguente:

<MyTag>

Contents of MyTag

</MyTag>

// Create a non-standard tag.
writer->RenderBeginTag( "MyTag" );
writer->Write( "Contents of MyTag" );
writer->RenderEndTag();
writer->WriteLine();

// Create a non-standard tag.
writer.RenderBeginTag("MyTag");
writer.Write("Contents of MyTag");
writer.RenderEndTag();
writer.WriteLine();

' Create a non-standard tag.
writer.RenderBeginTag("MyTag")
writer.Write("Contents of MyTag")
writer.RenderEndTag()
writer.WriteLine()

Commenti

Usare l'override RenderBeginTag del RenderBeginTag(String) metodo, se l'elemento markup non è uno dei valori di HtmlTextWriterTag enumerazione.

Per generare un elemento di markup usando il RenderBeginTag metodo, chiamare prima i AddAttribute metodi e AddStyleAttribute , in base alle esigenze, per specificare eventuali attributi di elemento o attributi di stile da visualizzare nel tag di apertura dell'elemento. Dopo aver generato il markup interno, chiamare il metodo per generare il RenderEndTag tag di chiusura.

Vedi anche

• TextWriter
• AddAttribute
• AddStyleAttribute
• RenderEndTag()

RenderBeginTag(HtmlTextWriterTag)

Scrive il tag di apertura dell'elemento di markup associato al valore di enumerazione di HtmlTextWriterTag specificato nel flusso di output.

public:
 virtual void RenderBeginTag(System::Web::UI::HtmlTextWriterTag tagKey);

public virtual void RenderBeginTag (System.Web.UI.HtmlTextWriterTag tagKey);

abstract member RenderBeginTag : System.Web.UI.HtmlTextWriterTag -> unit
override this.RenderBeginTag : System.Web.UI.HtmlTextWriterTag -> unit

Public Overridable Sub RenderBeginTag (tagKey As HtmlTextWriterTag)

Parametri

tagKey

HtmlTextWriterTag

Uno dei valori di HtmlTextWriterTag che definisce il tag di apertura dell'elemento di markup di cui eseguire il rendering.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il RenderBeginTag metodo per restituire il tag di apertura di un <img> elemento. Gli attributi aggiunti all'elemento dal AddAttribute metodo saranno nel tag di apertura <img> . Il RenderEndTag metodo viene usato per generare il tag di chiusura.

Questo esempio di codice genera il markup seguente:

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

</img>

// Control the encoding of attributes.
// 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();

// Control the encoding of attributes. 
// 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();

' Control the encoding of attributes.
' 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()

Commenti

Utilizzare l'overload RenderBeginTag del metodo se l'elemento RenderBeginTag(HtmlTextWriterTag) di markup è di un tipo noto che è uno dei valori di HtmlTextWriterTag enumerazione.

Per generare un elemento di markup usando il RenderBeginTag metodo, chiamare prima i AddAttribute metodi e AddStyleAttribute , in base alle esigenze, per specificare eventuali attributi di elemento o attributi di stile da visualizzare nel tag di apertura dell'elemento. Dopo aver generato il markup interno, chiamare il metodo per generare il RenderEndTag tag di chiusura.

Vedi anche

• TextWriter
• AddAttribute
• AddStyleAttribute
• RenderEndTag()