Freigeben über

HtmlTextWriter.NewLine Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI
Assembly:
System.Web.dll

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

public:
 virtual property System::String ^ NewLine { System::String ^ get(); void set(System::String ^ value); };
public override string NewLine { get; set; }
member this.NewLine : string with get, set
Public Overrides Property NewLine As String

Eigenschaftswert

String

Die vom aktuellen HtmlTextWriter verwendete Zeichenfolge für den Zeilenabschluss.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie eine benutzerdefinierte Klasse verwenden, die von der HtmlTextWriter Klasse abgeleitet wird, die die FilterAttributes Methode außer Kraft setzt. Wenn sie aufgerufen wird, überprüft die Außerkraftsetzung, ob der FilterAttributes Textautor alle <label> oder <a> Elemente gerendert. Wenn dies der Grund ist, bestimmt die FilterAttributes Methode, ob ein Formatattribute für die Bezeichnung definiert ist. Wenn keine Formatvorlage definiert ist, legt die FilterAttributes Methode den Standardwert für das style:color Attribut auf Blau fest. Die FilterAttributes Methode verwendet dann die NewLine Eigenschaft, um einen Zeilenumbruch im Markuptag einzufügen und alle anderen definierten Attribute zu schreiben.

// Override the FilterAttributes method to check whether 
// <label> and <anchor> elements contain specific attributes. 
virtual void FilterAttributes() override
{
   // 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.
   __super::FilterAttributes();
}

// 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 Overrides Sub 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 Then
        If Not IsAttributeDefined(HtmlTextWriterAttribute.Style) Then
            AddAttribute("style", EncodeAttributeValue("color:blue", True))
            Write(NewLine)
            Indent = 3
            OutputTabs()
        End If
    End If
    ' 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 Then
        If Not IsAttributeDefined(HtmlTextWriterAttribute.Href) Then
            AddAttribute("href", EncodeUrl("http://www.cohowinery.com"))
        End If
    End If

    ' Call the FilterAttributes method of the base class.
    MyBase.FilterAttributes()
End Sub

Hinweise

Die Standardzeilenterminatorzeichenfolge ist eine Wagenrückgabe, gefolgt von einem Zeilenfeed ("\r\n").

Die Zeilenterminatorzeichenfolge wird in den Ausgabedatenstrom geschrieben, wenn eine der WriteLine Methoden aufgerufen wird. Wenn die NewLine Eigenschaft auf null"Festgelegt" festgelegt ist, wird das Standardzeichen für neue Zeilen verwendet.

Gilt für

Siehe auch