Condividi tramite


HtmlTextWriter.WriteAttribute Metodo

Definizione

Scrive un attributo di markup e il relativo valore nel flusso di output.

Overload

WriteAttribute(String, String, Boolean)

Scrive il valore e l'attributo di markup specificati nel flusso di output e, se specificato, scrive il valore codificato.

WriteAttribute(String, String)

Scrive l'attributo di markup specificato e il relativo valore nel flusso di output.

WriteAttribute(String, String, Boolean)

Scrive il valore e l'attributo di markup specificati nel flusso di output e, se specificato, scrive il valore codificato.

public:
 virtual void WriteAttribute(System::String ^ name, System::String ^ value, bool fEncode);
public virtual void WriteAttribute (string name, string value, bool fEncode);
abstract member WriteAttribute : string * string * bool -> unit
override this.WriteAttribute : string * string * bool -> unit
Public Overridable Sub WriteAttribute (name As String, value As String, fEncode As Boolean)

Parametri

name
String

Attributo di markup da scrivere nel flusso di output.

value
String

Valore assegnato all'attributo.

fEncode
Boolean

true per codificare l'attributo e il valore assegnato. In caso contrario, false.

Esempio

Nell'esempio di codice seguente viene illustrato il rendering di un <img> elemento in cui vengono chiamati entrambi gli overload del WriteAttribute metodo . Nell'esempio di codice viene usato 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 , No "encoding" requirede quindi imposta su fEncodefalse.

  • 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

Usare il WriteAttribute metodo per scrivere attributi di markup e i relativi valori con o senza codifica. Il WriteAttribute metodo usa il HtmlAttributeEncode metodo per eseguire la codifica.

Il WriteAttribute metodo scrive il valore dell'attributo racchiuso tra virgolette doppie ("). Se value è null, il WriteAttribute metodo scrive solo il nome dell'attributo.

Note per gli eredi

Nelle classi derivate è possibile eseguire l'override del WriteAttribute(String, String, Boolean) metodo per definire regole personalizzate per la scrittura di attributi e i relativi valori. Ad esempio, è possibile scrivere codice che ha consentito al WriteAttribute(String, String, Boolean) metodo di scrivere un attributo con un valore vuoto.

Vedi anche

Si applica a

WriteAttribute(String, String)

Scrive l'attributo di markup specificato e il relativo valore nel flusso di output.

public:
 virtual void WriteAttribute(System::String ^ name, System::String ^ value);
public virtual void WriteAttribute (string name, string value);
abstract member WriteAttribute : string * string -> unit
override this.WriteAttribute : string * string -> unit
Public Overridable Sub WriteAttribute (name As String, value As String)

Parametri

name
String

Attributo da scrivere nel flusso di output.

value
String

Valore assegnato all'attributo.

Esempio

Nell'esempio di codice seguente viene illustrato il rendering di un <img> elemento in cui vengono chiamati entrambi gli overload del WriteAttribute metodo . Nell'esempio di codice viene usato 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 , No "encoding" requirede quindi imposta su fEncodefalse.

  • 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

Usare il WriteAttribute metodo per scrivere attributi di markup e i relativi valori senza codifica. Il WriteAttribute metodo scrive il valore dell'attributo racchiuso tra virgolette doppie ("). Se value è null, il WriteAttribute metodo scrive solo il nome dell'attributo.

Note per gli eredi

Nelle classi derivate è possibile eseguire l'override del WriteAttribute(String, String) metodo per definire regole personalizzate per la scrittura di attributi e i relativi valori. Ad esempio, è possibile scrivere codice che ha consentito al WriteAttribute(String, String) metodo di scrivere un attributo con un valore vuoto.

Vedi anche

Si applica a