HtmlTextWriter.AddStyleAttribute Method

Definition

Fügt dem Starttag des Elements, das das HtmlTextWriter-Objekt erstellt und anschließend die RenderBeginTag-Methode aufruft, ein Markupformatattribut hinzu.Adds a markup style attribute to the opening tag of the element that the HtmlTextWriter object creates with a subsequent call to the RenderBeginTag method.

Overloads

AddStyleAttribute(String, String)

Fügt dem Markupstarttag, das durch einen nachfolgenden Aufruf der RenderBeginTag-Methode erstellt wird, das angegebene Markupformatattribut und den Attributwert hinzu.Adds the specified markup style attribute and the attribute value to the opening markup tag created by a subsequent call to the RenderBeginTag method.

AddStyleAttribute(HtmlTextWriterStyle, String)

Fügt dem Start-Markuptag, das durch einen nachfolgenden Aufruf der HtmlTextWriterStyle-Methode erstellt wird, das im RenderBeginTag-Wert angegebene Markupformatattribut und den Attributwert hinzu.Adds the markup style attribute associated with the specified HtmlTextWriterStyle value and the attribute value to the opening markup tag created by a subsequent call to the RenderBeginTag method.

AddStyleAttribute(String, String, HtmlTextWriterStyle)

Fügt dem Start-Markuptag, das durch einen nachfolgenden Aufruf der HtmlTextWriterStyle-Methode erstellt wird, das angegebene Markupformatattribut und den Attributwert sowie einen RenderBeginTag-Enumerationswert hinzu.Adds the specified markup style attribute and the attribute value, along with an HtmlTextWriterStyle enumeration value, to the opening markup tag created by a subsequent call to the RenderBeginTag method.

AddStyleAttribute(String, String)

Fügt dem Markupstarttag, das durch einen nachfolgenden Aufruf der RenderBeginTag-Methode erstellt wird, das angegebene Markupformatattribut und den Attributwert hinzu.Adds the specified markup style attribute and the attribute value to the opening markup tag created by a subsequent call to the RenderBeginTag method.

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)

Parameters

name
String

Eine Zeichenfolge, die das hinzuzufügende Formatattribut enthält.A string that contains the style attribute to add.

value
String

Eine Zeichenfolge mit dem Wert, der dem Attribut zugewiesen wird.A string that contains the value to assign to the attribute.

Examples

Im folgenden Codebeispiel wird gezeigt, wie die RenderBeginTag Überladung der AddStyleAttribute(String, String)-Methode verwendet wird, um font-size und color Format Attribute für ein <p> Element zu Rendering.The following code example shows how to use the RenderBeginTag overload of the AddStyleAttribute(String, String) method to render font-size and color style attributes on a <p> element. In diesem Codebeispiel wird die HtmlTextWriter-Klasse verwendet, um den Inhalt des-Steuer Elements zu erzeugen.This code example uses the HtmlTextWriter class to render the contents of the control.

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

Remarks

Verwenden Sie die AddStyleAttribute Überladung der AddStyleAttribute(String, String)-Methode, wenn der Stil kein Member der HtmlTextWriterStyle-Enumeration ist oder bis zur Laufzeit bekannt ist.Use the AddStyleAttribute overload of the AddStyleAttribute(String, String) method when the style is not a member of the HtmlTextWriterStyle enumeration or is not known until run time.

Die HtmlTextWriter-Klasse verwaltet eine Liste von Stilen für die Markup Elemente, die Sie rendert.The HtmlTextWriter class maintains a list of styles for the markup elements it renders. Wenn die RenderBeginTag-Methode aufgerufen wird, werden alle von der AddStyleAttribute-Methode hinzugefügten Stile in das öffnende Tag des Elements gerendert.When the RenderBeginTag method is called, any styles that are added by the AddStyleAttribute method are rendered to the opening tag of the element. Die Liste der Stile wird dann gelöscht.The list of styles is then cleared.

Das Codierungs Muster zum Rendern von Markup Elementen lautet wie folgt:The coding pattern for rendering markup elements is as follows:

  • Verwenden Sie die AddStyleAttribute-Methode, um dem-Element beliebige Stil Attribute hinzuzufügen.Use the AddStyleAttribute method to add any style attributes to the element.

  • Verwenden Sie die RenderBeginTag-Methode.Use the RenderBeginTag method.

  • Verwenden Sie bei Bedarf andere Methoden, um den Inhalt zwischen dem öffnenden und dem schließenden Tag des Elements zu erzeugen.Use other methods as needed to render the content found between the element opening and closing tags.

  • Verwenden Sie die RenderEndTag-Methode.Use the RenderEndTag method.

See also

AddStyleAttribute(HtmlTextWriterStyle, String)

Fügt dem Start-Markuptag, das durch einen nachfolgenden Aufruf der HtmlTextWriterStyle-Methode erstellt wird, das im RenderBeginTag-Wert angegebene Markupformatattribut und den Attributwert hinzu.Adds the markup style attribute associated with the specified HtmlTextWriterStyle value and the attribute value to the opening markup tag created by a subsequent call to the RenderBeginTag method.

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)

Parameters

key
HtmlTextWriterStyle

Ein HtmlTextWriterStyle, der das Formatattribut darstellt, das im Ausgabestream hinzugefügt wird.An HtmlTextWriterStyle that represents the style attribute to add to the output stream.

value
String

Eine Zeichenfolge mit dem Wert, der dem Attribut zugewiesen wird.A string that contains the value to assign to the attribute.

Examples

Im folgenden Codebeispiel wird veranschaulicht, wie ein Teil einer Überschreibung der RenderBeginTag-Methode in einer Klasse verwendet wird, die von der HtmlTextWriter-Klasse abgeleitet wird.The following code example demonstrates how to use part of an override of the RenderBeginTag method in a class derived from the HtmlTextWriter class. Der Code überprüft, ob ein <Label> Element gerendert wird.The code checks whether a <Label> element is being rendered. Wenn dies der Fall ist, wird die IsStyleAttributeDefined-Methode aufgerufen, um zu überprüfen, ob ein Color Style-Attribut für das <Label>-Element definiert wurde.If so, the IsStyleAttributeDefined method is called to check whether a Color style attribute has been defined for the <Label> element. Wenn ein Color Attribut nicht definiert wurde, ruft der Code diese Überladung der AddStyleAttribute-Methode auf, um dem Formatvorlagen Attribut das Attribut Color hinzuzufügen, und legt dessen Wert auf redfest.If a Color attribute has not been defined, the code calls this overload of the AddStyleAttribute method to add the Color attribute to the style attribute, and then set its value to 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

Remarks

Verwenden Sie die AddStyleAttribute Überladung der AddStyleAttribute(HtmlTextWriterStyle, String)-Methode, wenn der Stil ein Member der HtmlTextWriterStyle-Enumeration ist und vor der Laufzeit bekannt ist.Use the AddStyleAttribute overload of the AddStyleAttribute(HtmlTextWriterStyle, String) method when the style is a member of the HtmlTextWriterStyle enumeration and is known before run time.

Die HtmlTextWriter-Klasse verwaltet eine Liste von Stilen für die Markup Elemente, die Sie rendert.The HtmlTextWriter class maintains a list of styles for the markup elements it renders. Wenn die RenderBeginTag-Methode aufgerufen wird, werden alle von der AddStyleAttribute-Methode hinzugefügten Stile in das öffnende Tag des Elements gerendert.When the RenderBeginTag method is called, any styles added by the AddStyleAttribute method are rendered to the opening tag of the element. Die Liste der Stile wird dann gelöscht.The list of styles is then cleared.

Das Codierungs Muster zum Rendern von Markup Elementen lautet wie folgt:The coding pattern for rendering markup elements is as follows:

  • Verwenden Sie die AddStyleAttribute-Methode, um dem-Element beliebige Stil Attribute hinzuzufügen.Use the AddStyleAttribute method to add any style attributes to the element.

  • Verwenden Sie die RenderBeginTag-Methode.Use the RenderBeginTag method.

  • Verwenden Sie bei Bedarf andere Methoden, um den Inhalt zwischen dem öffnenden und dem schließenden Tag des Elements zu erzeugen.Use other methods as needed to render the content found between the element opening and closing tags.

  • Verwenden Sie die RenderEndTag-Methode.Use the RenderEndTag method.

See also

AddStyleAttribute(String, String, HtmlTextWriterStyle)

Fügt dem Start-Markuptag, das durch einen nachfolgenden Aufruf der HtmlTextWriterStyle-Methode erstellt wird, das angegebene Markupformatattribut und den Attributwert sowie einen RenderBeginTag-Enumerationswert hinzu.Adds the specified markup style attribute and the attribute value, along with an HtmlTextWriterStyle enumeration value, to the opening markup tag created by a subsequent call to the RenderBeginTag method.

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)

Parameters

name
String

Eine Zeichenfolge, die das hinzuzufügende Formatattribut enthält.A string that contains the style attribute to be added.

value
String

Eine Zeichenfolge mit dem Wert, der dem Attribut zugewiesen wird.A string that contains the value to assign to the attribute.

key
HtmlTextWriterStyle

Ein HtmlTextWriterStyle, der das hinzuzufügende Formatattribut darstellt.An HtmlTextWriterStyle that represents the style attribute to add.

Remarks

Verwenden Sie die AddStyleAttribute Überladung der AddStyleAttribute(String, String, HtmlTextWriterStyle)-Methode nur, wenn Sie von der HtmlTextWriter-Klasse erbt.Use the AddStyleAttribute overload of the AddStyleAttribute(String, String, HtmlTextWriterStyle) method only when inheriting from the HtmlTextWriter class. Sie ermöglicht es Ihnen, neue name und value Paare für HtmlTextWriterStyle Attribute zu erstellen.It enables you to create new name and value pairs for HtmlTextWriterStyle attributes.

See also

Applies to