HtmlTextWriter.AddAttribute Metod

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)

Parametrar

Exempel

I följande kodexempel visas hur du anropar AddAttribute metoden innan du RenderBeginTag anropar metoden. Koden anropar två olika överlagringar av AddAttribute och två olika överlagringar av AddStyleAttribute innan den RenderBeginTag anropar metoden för att återge ett <span> element till utdataströmmen. Metoden AddAttribute(String, String) används för att definiera det anpassade attributet med namnet CustomAttribute och det anpassade värdet med namnet CustomAttributeValue på <span> det element som den här koden renderar.

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

Kommentarer

Använd överlagringen AddAttributeAddAttribute(String, String) av metoden om attributet inte är ett av HtmlTextWriterAttribute värdena, eller om attributet inte är känt förrän körningstiden.

För en instans av ett givet markeringselement HtmlTextWriter upprätthåller klassen en lista med attribut för det elementet. RenderBeginTag När metoden anropas återges alla attribut som läggs till av AddAttribute metoden till elementets öppningstagg. Listan över attribut rensas sedan från HtmlTextWriter objektet.

Kodningsmönstret för återgivning av markeringselement är följande:

• AddAttribute Använd metoden för att lägga till attribut i elementet.

• Använd RenderBeginTag-metoden.

• Använd andra metoder efter behov för att återge innehållet mellan elementets inledande och avslutande taggar.

• Använd RenderEndTag-metoden.

Se även

• TextWriter
• RenderBeginTag
• RenderEndTag()
• AddStyleAttribute

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)

Parametrar

Exempel

I följande kodexempel visas hur du använder överlagringen AddAttributeAddAttribute(HtmlTextWriterAttribute, String) av metoden för att lägga till ett Onclick attribut till ett markeringselement och sedan anger dess värde till följande ECMAScript-kod:

alert('Hello');

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

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

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

Kommentarer

Använd överlagringen AddAttribute av AddAttribute(HtmlTextWriterAttribute, String) metoden för att återge ett standardpåläggsattribut.

För en instans av ett givet markeringselement HtmlTextWriter upprätthåller klassen en lista med attribut för det elementet. RenderBeginTag När metoden anropas återges alla attribut som läggs till av AddAttribute metoden till elementets öppningstagg. Listan över attribut rensas sedan från HtmlTextWriter.

Kodningsmönstret för återgivning av markeringselement är följande:

• AddAttribute Använd metoden för att lägga till attribut i elementet.

• Använd RenderBeginTag-metoden.

• Använd andra metoder efter behov för att återge innehållet mellan elementets inledande och avslutande taggar.

• Använd RenderEndTag-metoden.

Se även

• TextWriter
• RenderBeginTag
• RenderEndTag()

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)

Parametrar

Exempel

I följande kodexempel visas hur du använder överlagringen AddAttributeAddAttribute(String, String, Boolean) av metoden för att säkerställa att ett anpassat attribut med namnet myattribute, och dess värde inte kodas för ett <img> element.

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

Kommentarer

Använd överlagringen AddAttributeAddAttribute(String, String, Boolean) av metoden om attributet inte är ett av HtmlTextWriterAttribute värdena, eller om attributet inte är känt förrän körningstid och kodning behövs.

För en instans av ett givet markeringselement HtmlTextWriter upprätthåller klassen en lista med attribut för det elementet. RenderBeginTag När metoden anropas återges alla attribut som läggs till av AddAttribute metoden till elementets öppningstagg. Listan över attribut rensas sedan från HtmlTextWriter objektet.

AddAttribute(String, String, Boolean) Använd metoden med fEncode värdet true, om attributet eventuellt kan innehålla ett citattecken ("), ett mindre än -tecken (<) eller ett et-tecken (&). Metodanropet kodar attributet för att uppfylla kraven för den begärande enheten. Du kan ange fEncode till false, om du vet att inget av dessa tecken kommer att genereras, eller om du vet att attributet redan är kodat.

Om attributtypen är Stylekodas inte värdet även om fEndode är true. Kontrollera att formatvärdet är CSS-kompatibelt och inte innehåller skadlig kod.

Kodningsmönstret för återgivning av markeringselement är följande:

• AddAttribute Använd metoden för att lägga till attribut i elementet.

• Använd RenderBeginTag-metoden.

• Använd andra metoder efter behov för att återge innehållet mellan elementets inledande och avslutande taggar.

• Använd RenderEndTag-metoden.

Se även

• TextWriter
• HttpRequest
• RenderBeginTag
• HtmlTextWriterAttribute
• HtmlAttributeEncode(String, TextWriter)

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)

Parametrar

Kommentarer

AddAttribute Använd endast överlagringen AddAttribute(String, String, HtmlTextWriterAttribute) av metoden när du ärver från HtmlTextWriter klassen. Det gör att du kan skapa nya name och key par för attribut.

Se även

• TextWriter
• RenderBeginTag
• HtmlTextWriterAttribute

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)

Parametrar

Exempel

Följande kodexempel visar hur du använder AddAttribute(HtmlTextWriterAttribute, String, Boolean) metoden för att säkerställa att strängvärdet som tilldelas till ett Alt attribut för ett <img> element kodas för den begärande enheten.

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

Kommentarer

Använd överlagringen AddAttributeAddAttribute(HtmlTextWriterAttribute, String, Boolean) av metoden för att återge ett standardteckenattribut med valfri kodning.

För en instans av ett givet markeringselement HtmlTextWriter upprätthåller klassen en lista med attribut för det elementet. RenderBeginTag När metoden anropas återges alla attribut som läggs till av elementets AddAttribute öppningstagg. Listan över attribut rensas sedan från HtmlTextWriter objektet.

AddAttribute(HtmlTextWriterAttribute, String, Boolean) Använd metoden med fEncode värdet true, om attributet eventuellt kan innehålla ett citattecken ("), ett mindre än -tecken (<) eller ett et-tecken (&). Metodanropet kodar attributet för att uppfylla kraven för den begärande enheten. Du kan ange fEncode till false, om du vet att inget av dessa tecken kommer att genereras, eller om du vet att attributet redan är kodat.

Om attributtypen är Stylekodas inte värdet även om fEncode är true. Kontrollera att formatvärdet är CSS-kompatibelt och inte innehåller skadlig kod.

Kodningsmönstret för återgivning av markeringselement är följande:

• AddAttribute Använd metoden för att lägga till attribut i elementet.

• Använd RenderBeginTag-metoden.

• Använd andra metoder efter behov för att återge innehållet mellan elementets inledande och avslutande taggar.

• Använd RenderEndTag-metoden.

Se även

• TextWriter
• HttpRequest
• RenderBeginTag
• HtmlTextWriterAttribute
• HtmlAttributeEncode(String, TextWriter)