HtmlTextWriter.WriteAttribute Methode

Definitie

Hiermee schrijft u een markeringskenmerk en de bijbehorende waarde naar de uitvoerstroom.

Overloads

Name Description
WriteAttribute(String, String, Boolean)

Schrijft het opgegeven markeringskenmerk en de opgegeven waarde naar de uitvoerstroom en schrijft, indien opgegeven, de waarde die is gecodeerd.

WriteAttribute(String, String)

Hiermee schrijft u het opgegeven markeringskenmerk en de opgegeven waarde naar de uitvoerstroom.

WriteAttribute(String, String, Boolean)

Schrijft het opgegeven markeringskenmerk en de opgegeven waarde naar de uitvoerstroom en schrijft, indien opgegeven, de waarde die is gecodeerd.

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)

Parameters

name
String

Het kenmerk voor markeringen om naar de uitvoerstroom te schrijven.

value
String

De waarde die is toegewezen aan het kenmerk.

fEncode
Boolean

true om het kenmerk en de toegewezen waarde ervan te coderen; anders, false.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe een <img> element wordt weergegeven waarin beide overbelastingen van de WriteAttribute methode worden aangeroepen. In het codevoorbeeld wordt het volgende proces gebruikt:

  • Roept de WriteBeginTag methode aan, waarmee de openingstekens van het element worden weergegeven.

  • Roept de WriteAttribute(String, String) overbelasting aan, waarmee een alt kenmerk en de bijbehorende waarde naar het <img> element worden geschreven.

  • Roept de WriteAttribute(String, String, Boolean) overbelasting aan om een aangepast myattribute kenmerk weer te geven, met een waarde van No "encoding" requireden wordt vervolgens ingesteld fEncode op false.

  • Hiermee sluit u de openingstag van het element en roept u vervolgens de WriteEndTag methode aan om het <img> element te sluiten.

In dit codevoorbeeld worden de volgende markeringen gegenereerd:

<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)

Opmerkingen

Gebruik de WriteAttribute methode om markeringskenmerken en hun waarden te schrijven met of zonder codering. De WriteAttribute methode gebruikt de HtmlAttributeEncode methode om de codering uit te voeren.

De WriteAttribute methode schrijft de kenmerkwaarde tussen dubbele aanhalingstekens ("). Als value dat het is null, schrijft de WriteAttribute methode alleen de kenmerknaam.

Notities voor overnemers

In afgeleide klassen kunt u de WriteAttribute(String, String, Boolean) methode overschrijven om aangepaste regels te definiëren voor het schrijven van kenmerken en hun waarden. U kunt bijvoorbeeld code schrijven waarmee de WriteAttribute(String, String, Boolean) methode een kenmerk met een lege waarde kon schrijven.

Zie ook

Van toepassing op

WriteAttribute(String, String)

Hiermee schrijft u het opgegeven markeringskenmerk en de opgegeven waarde naar de uitvoerstroom.

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)

Parameters

name
String

Het kenmerk dat moet worden geschreven naar de uitvoerstroom.

value
String

De waarde die is toegewezen aan het kenmerk.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe een <img> element wordt weergegeven waarin beide overbelastingen van de WriteAttribute methode worden aangeroepen. In het codevoorbeeld wordt het volgende proces gebruikt:

  • Roept de WriteBeginTag methode aan, waarmee de openingstekens van het element worden weergegeven.

  • Roept de WriteAttribute(String, String) overbelasting aan, waarmee een alt kenmerk en de bijbehorende waarde naar het <img> element worden geschreven.

  • Roept de WriteAttribute(String, String, Boolean) overbelasting aan om een aangepast myattribute kenmerk weer te geven, met een waarde van No "encoding" requireden wordt vervolgens ingesteld fEncode op false.

  • Hiermee sluit u de openingstag van het element en roept u vervolgens de WriteEndTag methode aan om het <img> element te sluiten.

In dit codevoorbeeld worden de volgende markeringen gegenereerd:

<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)

Opmerkingen

Gebruik de WriteAttribute methode om markeringskenmerken en hun waarden zonder codering te schrijven. De WriteAttribute methode schrijft de kenmerkwaarde tussen dubbele aanhalingstekens ("). Als value dat het is null, schrijft de WriteAttribute methode alleen de kenmerknaam.

Notities voor overnemers

In afgeleide klassen kunt u de WriteAttribute(String, String) methode overschrijven om aangepaste regels te definiëren voor het schrijven van kenmerken en hun waarden. U kunt bijvoorbeeld code schrijven waarmee de WriteAttribute(String, String) methode een kenmerk met een lege waarde kon schrijven.

Zie ook

Van toepassing op