Freigeben über


HtmlTextWriter.AddStyleAttribute Methode

Definition

Fügt dem Starttag des Elements, das das HtmlTextWriter-Objekt erstellt und anschließend die RenderBeginTag-Methode aufruft, ein Markupformatattribut hinzu.

Überlädt

AddStyleAttribute(String, String)

Fügt dem Markupstarttag, das durch einen nachfolgenden Aufruf der RenderBeginTag-Methode erstellt wird, das angegebene Markupformatattribut und den Attributwert hinzu.

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.

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.

AddStyleAttribute(String, String)

Fügt dem Markupstarttag, das durch einen nachfolgenden Aufruf der RenderBeginTag-Methode erstellt wird, das angegebene Markupformatattribut und den Attributwert hinzu.

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

name
String

Eine Zeichenfolge, die das hinzuzufügende Formatattribut enthält.

value
String

Eine Zeichenfolge mit dem Wert, der dem Attribut zugewiesen wird.

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

Gilt für

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.

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

key
HtmlTextWriterStyle

Ein HtmlTextWriterStyle, der das Formatattribut darstellt, das im Ausgabestream hinzugefügt wird.

value
String

Eine Zeichenfolge mit dem Wert, der dem Attribut zugewiesen wird.

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

Gilt für

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.

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

name
String

Eine Zeichenfolge, die das hinzuzufügende Formatattribut enthält.

value
String

Eine Zeichenfolge mit dem Wert, der dem Attribut zugewiesen wird.

key
HtmlTextWriterStyle

Ein HtmlTextWriterStyle, der das hinzuzufügende Formatattribut darstellt.

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

Gilt für