HtmlTextWriter.AddAttribute Methode

Definitie

Naamruimte:: System.Web.UI

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Voegt het opgegeven markeringskenmerk en de opgegeven waarde toe aan de openingstag van het element dat het HtmlTextWriter object maakt met een volgende aanroep naar de RenderBeginTag methode.

Overloads

Name	Description
AddAttribute(String, String)	Voegt het opgegeven markeringskenmerk en de opgegeven waarde toe aan de openingstag van het element dat het HtmlTextWriter object maakt met een volgende aanroep naar de RenderBeginTag methode.
AddAttribute(HtmlTextWriterAttribute, String)	Hiermee worden het kenmerk markeringen en de kenmerkwaarde toegevoegd aan de openingstag van het element dat door het HtmlTextWriter object wordt gemaakt met een volgende aanroep van de RenderBeginTag methode.
AddAttribute(String, String, Boolean)	Voegt het opgegeven markeringskenmerk en de waarde toe aan de openingstag van het element dat het HtmlTextWriter object maakt met een volgende aanroep van de RenderBeginTag methode, met optionele codering.
AddAttribute(String, String, HtmlTextWriterAttribute)	Voegt het opgegeven markeringskenmerk en de opgegeven waarde, samen met een HtmlTextWriterAttribute opsommingswaarde, toe aan de openingstag van het element dat het HtmlTextWriter object maakt met een volgende aanroep naar de RenderBeginTag methode.
AddAttribute(HtmlTextWriterAttribute, String, Boolean)	Voegt het kenmerk markeringen en de kenmerkwaarde toe aan de openingstag van het element dat het HtmlTextWriter object maakt met een volgende aanroep van de RenderBeginTag methode, met optionele codering.

AddAttribute(String, String)

Voegt het opgegeven markeringskenmerk en de opgegeven waarde toe aan de openingstag van het element dat het HtmlTextWriter object maakt met een volgende aanroep naar de RenderBeginTag methode.

public:
 virtual void AddAttribute(System::String ^ name, System::String ^ value);

public virtual void AddAttribute(string name, string value);

abstract member AddAttribute : string * string -> unit
override this.AddAttribute : string * string -> unit

Public Overridable Sub AddAttribute (name As String, value As String)

Parameters

name: String

Een tekenreeks met de naam van het kenmerk dat moet worden toegevoegd.

value: String

Een tekenreeks met de waarde die moet worden toegewezen aan het kenmerk.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de AddAttribute methode aanroept voordat u de RenderBeginTag methode aanroept. De code roept twee verschillende overbelastingen van en twee verschillende overbelastingen aan AddAttribute AddStyleAttribute voordat de methode wordt RenderBeginTag aangeroepen om een <span> element weer te geven aan de uitvoerstroom. De AddAttribute(String, String) methode wordt gebruikt voor het definiëren van het aangepaste kenmerk met de naam CustomAttribute en de aangepaste waarde die wordt genoemd CustomAttributeValue voor het <span> element dat door deze code wordt weergegeven.

// 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++;

' 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

Opmerkingen

Gebruik de AddAttribute overbelasting van de AddAttribute(String, String) methode als het kenmerk geen van de HtmlTextWriterAttribute waarden is of als het kenmerk pas bekend is als de uitvoeringstijd van het kenmerk niet bekend is.

Voor een exemplaar van een bepaald opmaakelement onderhoudt de HtmlTextWriter klasse een lijst met kenmerken voor dat element. Wanneer de RenderBeginTag methode wordt aangeroepen, worden alle kenmerken die door de AddAttribute methode worden toegevoegd, weergegeven aan de openingstag van het element. De lijst met kenmerken wordt vervolgens gewist uit het HtmlTextWriter object.

Het coderingspatroon voor renderingmarkeringselementen is als volgt:

Gebruik de AddAttribute methode om kenmerken aan het element toe te voegen.
Gebruik de RenderBeginTag methode.
Gebruik indien nodig andere methoden om de inhoud weer te geven die is gevonden tussen de openings- en sluitingstags van het element.
Gebruik de RenderEndTag methode.

Zie ook

Van toepassing op

AddAttribute(HtmlTextWriterAttribute, String)

Hiermee worden het kenmerk markeringen en de kenmerkwaarde toegevoegd aan de openingstag van het element dat door het HtmlTextWriter object wordt gemaakt met een volgende aanroep van de RenderBeginTag methode.

public:
 virtual void AddAttribute(System::Web::UI::HtmlTextWriterAttribute key, System::String ^ value);

public virtual void AddAttribute(System.Web.UI.HtmlTextWriterAttribute key, string value);

abstract member AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string -> unit
override this.AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string -> unit

Public Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String)

Parameters

key: HtmlTextWriterAttribute

Een HtmlTextWriterAttribute kenmerk voor markeringen dat moet worden toegevoegd aan de uitvoerstroom.

value: String

Een tekenreeks met de waarde die moet worden toegewezen aan het kenmerk.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de AddAttribute overbelasting van de AddAttribute(HtmlTextWriterAttribute, String) methode gebruikt om een Onclick kenmerk toe te voegen aan een markeringselement en vervolgens de waarde ervan in te stellen op de volgende ECMAScript-code:

alert('Hello');

writer->AddAttribute( HtmlTextWriterAttribute::Onclick, "alert('Hello');" );

writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");

writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")

Opmerkingen

Gebruik de AddAttribute overbelasting van de AddAttribute(HtmlTextWriterAttribute, String) methode om een standaardmarkeringskenmerk weer te geven.

Het coderingspatroon voor renderingmarkeringselementen is als volgt:

Gebruik de AddAttribute methode om kenmerken aan het element toe te voegen.
Gebruik de RenderBeginTag methode.
Gebruik indien nodig andere methoden om de inhoud weer te geven die is gevonden tussen de openings- en sluitingstags van het element.
Gebruik de RenderEndTag methode.

Zie ook

Van toepassing op

AddAttribute(String, String, Boolean)

Voegt het opgegeven markeringskenmerk en de waarde toe aan de openingstag van het element dat het HtmlTextWriter object maakt met een volgende aanroep van de RenderBeginTag methode, met optionele codering.

public:
 virtual void AddAttribute(System::String ^ name, System::String ^ value, bool fEndode);

public virtual void AddAttribute(string name, string value, bool fEndode);

abstract member AddAttribute : string * string * bool -> unit
override this.AddAttribute : string * string * bool -> unit

Public Overridable Sub AddAttribute (name As String, value As String, fEndode As Boolean)

Parameters

name: String

Een tekenreeks met de naam van het kenmerk dat moet worden toegevoegd.

value: String

Een tekenreeks met de waarde die moet worden toegewezen aan het kenmerk.

fEndode: Boolean

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

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de AddAttribute overbelasting van de AddAttribute(String, String, Boolean) methode gebruikt om ervoor te zorgen dat een aangepast kenmerk, met de naam myattributeen de waarde ervan niet voor een <img> element worden gecodeerd.

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

Opmerkingen

Gebruik de AddAttribute overbelasting van de AddAttribute(String, String, Boolean) methode als het kenmerk geen van de HtmlTextWriterAttribute waarden is of als het kenmerk pas bekend is als de uitvoeringstijd en codering nodig zijn.

Gebruik de AddAttribute(String, String, Boolean) methode die is fEncode ingesteld op true, als het kenmerk mogelijk een aanhalingsteken ("), een teken (<) of een ampersand (&) kan bevatten. Met de methode-aanroep wordt het kenmerk gecodeerd om te voldoen aan de vereisten van het aangevraagde apparaat. U kunt instellen fEncode op false, als u weet dat geen van deze tekens wordt gegenereerd of als u weet dat het kenmerk al is gecodeerd.

Als het kenmerktype is Style, wordt de waarde niet gecodeerd, zelfs niet als fEndode dat het is true. Zorg ervoor dat de stijlwaarde CSS-compatibel is en geen schadelijke code bevat.

Het coderingspatroon voor renderingmarkeringselementen is als volgt:

Gebruik de AddAttribute methode om kenmerken aan het element toe te voegen.
Gebruik de RenderBeginTag methode.
Gebruik indien nodig andere methoden om de inhoud weer te geven die is gevonden tussen de openings- en sluitingstags van het element.
Gebruik de RenderEndTag methode.

Zie ook

Van toepassing op

AddAttribute(String, String, HtmlTextWriterAttribute)

Voegt het opgegeven markeringskenmerk en de opgegeven waarde, samen met een HtmlTextWriterAttribute opsommingswaarde, toe aan de openingstag van het element dat het HtmlTextWriter object maakt met een volgende aanroep naar de RenderBeginTag methode.

protected:
 virtual void AddAttribute(System::String ^ name, System::String ^ value, System::Web::UI::HtmlTextWriterAttribute key);

protected virtual void AddAttribute(string name, string value, System.Web.UI.HtmlTextWriterAttribute key);

abstract member AddAttribute : string * string * System.Web.UI.HtmlTextWriterAttribute -> unit
override this.AddAttribute : string * string * System.Web.UI.HtmlTextWriterAttribute -> unit

Protected Overridable Sub AddAttribute (name As String, value As String, key As HtmlTextWriterAttribute)

Parameters

name: String

Een tekenreeks met de naam van het kenmerk dat moet worden toegevoegd.

value: String

Een tekenreeks met de waarde die moet worden toegewezen aan het kenmerk.

key: HtmlTextWriterAttribute

Een HtmlTextWriterAttribute die het kenmerk vertegenwoordigt.

Opmerkingen

Gebruik de AddAttribute overbelasting van de AddAttribute(String, String, HtmlTextWriterAttribute) methode alleen bij het overnemen van de HtmlTextWriter klasse. Hiermee kunt u nieuwe name en key paren voor kenmerken maken.

Zie ook

Van toepassing op

AddAttribute(HtmlTextWriterAttribute, String, Boolean)

Voegt het kenmerk markeringen en de kenmerkwaarde toe aan de openingstag van het element dat het HtmlTextWriter object maakt met een volgende aanroep van de RenderBeginTag methode, met optionele codering.

public:
 virtual void AddAttribute(System::Web::UI::HtmlTextWriterAttribute key, System::String ^ value, bool fEncode);

public virtual void AddAttribute(System.Web.UI.HtmlTextWriterAttribute key, string value, bool fEncode);

abstract member AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string * bool -> unit
override this.AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string * bool -> unit

Public Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String, fEncode As Boolean)

Parameters

key: HtmlTextWriterAttribute

Een HtmlTextWriterAttribute kenmerk voor markeringen dat moet worden toegevoegd aan de uitvoerstroom.

value: String

Een tekenreeks met de waarde die moet worden toegewezen aan het kenmerk.

fEncode: Boolean

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

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de AddAttribute(HtmlTextWriterAttribute, String, Boolean) methode gebruikt om ervoor te zorgen dat de tekenreekswaarde die is toegewezen aan een Alt kenmerk voor een <img> element is gecodeerd voor het aanvragende apparaat.

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

Opmerkingen

Gebruik de AddAttribute overbelasting van de AddAttribute(HtmlTextWriterAttribute, String, Boolean) methode om een standaardmarkeringskenmerk weer te geven, met optionele codering.

Gebruik de AddAttribute(HtmlTextWriterAttribute, String, Boolean) methode die is fEncode ingesteld op true, als het kenmerk mogelijk een aanhalingsteken ("), een teken (<) of een ampersand (&) kan bevatten. Met de methode-aanroep wordt het kenmerk gecodeerd om te voldoen aan de vereisten van het aangevraagde apparaat. U kunt instellen fEncode op false, als u weet dat geen van deze tekens wordt gegenereerd of als u weet dat het kenmerk al is gecodeerd.

Als het kenmerktype is Style, wordt de waarde niet gecodeerd, zelfs niet als fEncode dat het is true. Zorg ervoor dat de stijlwaarde CSS-compatibel is en geen schadelijke code bevat.

Het coderingspatroon voor renderingmarkeringselementen is als volgt:

Gebruik de AddAttribute methode om kenmerken aan het element toe te voegen.
Gebruik de RenderBeginTag methode.
Gebruik indien nodig andere methoden om de inhoud weer te geven die is gevonden tussen de openings- en sluitingstags van het element.
Gebruik de RenderEndTag methode.

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?