HtmlTextWriter.AddStyleAttribute Methode

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

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

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

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

Parameter

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie die RenderBeginTag Überladung der AddStyleAttribute(String, String) Methode zum Rendern font-size und color Formatieren von Attributen auf einem <p> Element verwenden. In diesem Codebeispiel wird die HtmlTextWriter Klasse verwendet, um den Inhalt des Steuerelements zu rendern.

// Add style attribute for 'p'(paragraph) element.
writer->AddStyleAttribute( "font-size", "12pt" );
writer->AddStyleAttribute( "color", "fuchsia" );
// Output the 'p' (paragraph) element with the style attributes.
writer->RenderBeginTag( "p" );
// Output the 'Message' property contents and the time on the server.
writer->Write( String::Concat( Message, "<br>",
   "The time on the server: ",
   System::DateTime::Now.ToLongTimeString() ) );

// Close the element.
writer->RenderEndTag();

// Add style attribute for 'p'(paragraph) element.
writer.AddStyleAttribute("font-size", "12pt");
writer.AddStyleAttribute("color", "fuchsia");
// Output the 'p' (paragraph) element with the style attributes.
writer.RenderBeginTag("p");
// Output the 'Message' property contents and the time on the server.
writer.Write(Message + "<br>" +
    "The time on the server: " +
    System.DateTime.Now.ToLongTimeString());

// Close the element.
writer.RenderEndTag();

'Add style attribute for 'p'(paragraph) element.
writer.AddStyleAttribute("font-size", "12pt")
writer.AddStyleAttribute("color", "fuchsia")

'Output the 'p' (paragraph) element with the style attributes.
writer.RenderBeginTag("p")

'Output the 'Message' property contents and the time on the server.
writer.Write((Message & "<br>" & "The time on the server: " & _
   System.DateTime.Now.ToLongTimeString()))

' Close the element.
writer.RenderEndTag()

Hinweise

Verwenden Sie die AddStyleAttribute Überladung der AddStyleAttribute(String, String) Methode, wenn die Formatvorlage kein Element der HtmlTextWriterStyle Aufzählung ist oder bis zur Laufzeit nicht bekannt ist.

Die HtmlTextWriter Klasse verwaltet eine Liste der Formatvorlagen für die Markupelemente, die sie rendert. Wenn die RenderBeginTag Methode aufgerufen wird, werden alle Formatvorlagen, die von der Methode hinzugefügt werden, an das AddStyleAttribute öffnende Tag des Elements gerendert. Die Liste der Formatvorlagen wird dann gelöscht.

Das Codierungsmuster für Das Rendern von Markupelementen ist wie folgt:

• Verwenden Sie die AddStyleAttribute Methode, um dem Element alle Formatattribute hinzuzufügen.

• Verwenden Sie die RenderBeginTag-Methode.

• Verwenden Sie andere Methoden, um den Inhalt zu rendern, der zwischen dem Öffnen und Schließen von Tags des Elements gefunden wurde.

• Verwenden Sie die RenderEndTag-Methode.

Siehe auch

• TextWriter
• HtmlTextWriterStyle
• RenderBeginTag

public:
 virtual void AddStyleAttribute(System::Web::UI::HtmlTextWriterStyle key, System::String ^ value);

public virtual void AddStyleAttribute (System.Web.UI.HtmlTextWriterStyle key, string value);

abstract member AddStyleAttribute : System.Web.UI.HtmlTextWriterStyle * string -> unit
override this.AddStyleAttribute : System.Web.UI.HtmlTextWriterStyle * string -> unit

Public Overridable Sub AddStyleAttribute (key As HtmlTextWriterStyle, value As String)

Parameter

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie einen Teil einer Außerkraftsetzung der RenderBeginTag Methode in einer von der HtmlTextWriter Klasse abgeleiteten Klasse verwenden. Der Code überprüft, ob ein <Label> Element gerendert wird. Wenn dies der Grund ist, wird die IsStyleAttributeDefined Methode aufgerufen, um zu überprüfen, ob ein Color Formatattribute für das <Label> Element definiert wurde. Wenn ein Color Attribut nicht definiert wurde, ruft der Code diese Überladung der AddStyleAttribute Methode auf, um das Color Attribut dem Formatattribut hinzuzufügen, und legt dann seinen Wert auf red.

// If the markup element being rendered is a Label,
// render the opening tag of a <Font> element before it.
if ( tagKey == HtmlTextWriterTag::Label )
{
   
   // Check whether a Color style attribute is
   // included on the Label. If not, use the
   // AddStyleAttribute and GetStyleName methods to add one
   // and set its value to red.
   if (  !IsStyleAttributeDefined( HtmlTextWriterStyle::Color ) )
   {
      AddStyleAttribute( GetStyleName( HtmlTextWriterStyle::Color ), "red" );
   }

// If the markup element being rendered is a Label,
// render the opening tag of a Font element before it.
if (tagKey == HtmlTextWriterTag.Label)
{
    // Check whether a Color style attribute is 
    // included on the Label. If not, use the
    // AddStyleAttribute and GetStyleName methods to add one
    // and set its value to red.
    if (!IsStyleAttributeDefined(HtmlTextWriterStyle.Color))
    {
        AddStyleAttribute(GetStyleName(HtmlTextWriterStyle.Color), "red");
    }

' If the markup element being rendered is a Label,
' render the opening tag of a Font element before it.
If tagKey = HtmlTextWriterTag.Label Then
    ' Check whether a Color style attribute is 
    ' included on the Label. If not, use the
    ' AddStyleAttribute and GetStyleName methods to add one
    ' and set its value to red.
    If Not IsStyleAttributeDefined(HtmlTextWriterStyle.Color) Then
        AddStyleAttribute(GetStyleName(HtmlTextWriterStyle.Color), "red")
    End If

Hinweise

Verwenden Sie die AddStyleAttribute Überladung der Methode, wenn die Formatvorlage ein Element der AddStyleAttribute(HtmlTextWriterStyle, String) HtmlTextWriterStyle Enumeration ist und vor der Laufzeit bekannt ist.

Die HtmlTextWriter Klasse verwaltet eine Liste der Formatvorlagen für die Markupelemente, die sie rendert. Wenn die Methode aufgerufen wird, werden alle formatvorlagen, die RenderBeginTag von der Methode hinzugefügt werden, an das AddStyleAttribute öffnende Tag des Elements gerendert. Die Liste der Formatvorlagen wird dann gelöscht.

Das Codierungsmuster für Das Rendern von Markupelementen ist wie folgt:

• Verwenden Sie die AddStyleAttribute Methode, um dem Element alle Formatattribute hinzuzufügen.

• Verwenden Sie die RenderBeginTag-Methode.

• Verwenden Sie andere Methoden, um den Inhalt zu rendern, der zwischen dem Öffnen und Schließen von Tags des Elements gefunden wurde.

• Verwenden Sie die RenderEndTag-Methode.

Siehe auch

• TextWriter
• HtmlTextWriterStyle
• RenderBeginTag

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

protected virtual void AddStyleAttribute (string name, string value, System.Web.UI.HtmlTextWriterStyle key);

abstract member AddStyleAttribute : string * string * System.Web.UI.HtmlTextWriterStyle -> unit
override this.AddStyleAttribute : string * string * System.Web.UI.HtmlTextWriterStyle -> unit

Protected Overridable Sub AddStyleAttribute (name As String, value As String, key As HtmlTextWriterStyle)

Parameter

Hinweise

Verwenden Sie die AddStyleAttribute Überladung der Methode nur beim Erben von der AddStyleAttribute(String, String, HtmlTextWriterStyle) HtmlTextWriter Klasse. Es ermöglicht Ihnen, neue name und value Paare für HtmlTextWriterStyle Attribute zu erstellen.

Siehe auch

• TextWriter
• RenderBeginTag
• HtmlTextWriterStyle