Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

HtmlTextWriter.NewLine-Eigenschaft

Aktualisiert: November 2007

Ruft die Zeichenfolge für den Zeilenabschluss ab, die vom HtmlTextWriter-Objekt verwendet wird, oder legt diese fest.

Namespace:  System.Web.UI
Assembly:  System.Web (in System.Web.dll)

public override string NewLine { get; set; }
/** @property */
public String get_NewLine()
/** @property */
public  void set_NewLine(String value)

public override function get NewLine () : String
public override function set NewLine (value : String)

Eigenschaftenwert

Typ: System.String
Die vom aktuellen HtmlTextWriter verwendete Zeichenfolge für den Zeilenabschluss.

Die Standardzeichenfolge für den Zeilenabschluss ist ein Wagenrücklauf gefolgt von einem Zeilenvorschub ("\r\n").

Die Zeichenfolge für den Zeilenabschluss wird immer dann in den Ausgabestream geschrieben, wenn eine der WriteLine-Methoden aufgerufen wird. Wenn die NewLine-Eigenschaft auf null festgelegt ist, wird die Standard-Zeilenendemarke verwendet.

Im folgenden Codebeispiel wird die Verwendung einer benutzerdefinierten von der HtmlTextWriter-Klasse abgeleiteten Klasse veranschaulicht, die die FilterAttributes-Methode überschreibt. Beim Aufruf überprüft die FilterAttributes-Überschreibung, ob der Textwriter <label>-Elemente oder <a>-Elemente rendert. Wenn dies der Fall ist, bestimmt die FilterAttributes-Methode, ob für die Beschriftung ein Formatattribut definiert ist. Wenn kein Format definiert ist, legt die FilterAttributes-Methode den Standardwert für das style:color-Attribut auf die Farbe Blau festgelegt. Anschließend fügt die FilterAttributes-Methode mithilfe der NewLine-Eigenschaft einen Zeilenumbruch in das Markuptag ein und schreibt beliebige andere definierte Attribute.

// Override the FilterAttributes method to check whether 
// <label> and <anchor> elements contain specific attributes.      
protected override void FilterAttributes()
{
    // If the <label> element is rendered and a style
    // attribute is not defined, add a style attribute 
    // and set its value to blue.
    if (TagKey == HtmlTextWriterTag.Label)
    {
        if (!IsAttributeDefined(HtmlTextWriterAttribute.Style))
        {
            AddAttribute("style", EncodeAttributeValue("color:blue", true));
            Write(NewLine);
            Indent = 3;
            OutputTabs();
        }
    }

    // If an <anchor> element is rendered and an href
    // attribute has not been defined, call the AddAttribute
    // method to add an href attribute
    // and set it to http://www.cohowinery.com.
    // Use the EncodeUrl method to convert any spaces to %20.
    if (TagKey == HtmlTextWriterTag.A)
    {
        if (!IsAttributeDefined(HtmlTextWriterAttribute.Href))
        {
            AddAttribute("href", EncodeUrl("http://www.cohowinery.com"));
        }
    }
    // Call the FilterAttributes method of the base class.
    base.FilterAttributes();
}


// Override the FilterAttributes method to check whether 
// <label> and <anchor> elements contain specific attributes.      
protected void FilterAttributes()
{
    // If the Label tag is being rendered and a style
    // attribute is not defined, add a style attribute 
    // and set its value to blue.
    if (get_TagKey().Equals(HtmlTextWriterTag.Label)) {
        if (!(IsAttributeDefined(HtmlTextWriterAttribute.Style))) {
            AddAttribute("style", EncodeAttributeValue("color:blue",
                true));
            Write(get_NewLine());
            set_Indent(3);
            OutputTabs();
        }
    }

    // If an Anchor element is being rendered and an href
    // attribute has not been defined, call the AddAttribute
    // method to add an href
    // attribute and set it to http://www.cohowinery.com.
    // Use the EncodeUrl method to convert any spaces to %20.
    if (get_TagKey().Equals(HtmlTextWriterTag.A)) {
        if (!(IsAttributeDefined(HtmlTextWriterAttribute.Href))) {
            AddAttribute("href", EncodeUrl("http://www.cohowinery.com"));
        }
    }

    // Call the FilterAttributes method of the base class.
    super.FilterAttributes();
} //FilterAttributes


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0, 1.1, 1.0
Anzeigen: