StringBuilder.AppendLine Methode

Definition

Namespace:

System.Text

Assembly:

System.Runtime.dll

Fügt das Standardzeilenabschlusszeichen oder eine Kopie der angegebenen Zeichenfolge und das Standardzeilenabschlusszeichen am Ende dieser Instanz an.

Überlädt

AppendLine()	Fügt das Standardzeilenabschlusszeichen am Ende des aktuellen StringBuilder-Objekts an.
AppendLine(String)	Fügt eine Kopie der angegebenen Zeichenfolge gefolgt vom Standardzeilenabschlusszeichen am Ende des aktuellen StringBuilder-Objekts an.
AppendLine(StringBuilder+AppendInterpolatedStringHandler)	Fügt die angegebene interpolierte Zeichenfolge gefolgt vom Standardzeilenabschluss an das Ende des aktuellen StringBuilder-Objekts an.
AppendLine(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)	Fügt die angegebene interpolierte Zeichenfolge im angegebenen Format, gefolgt vom Standardzeilenabschluss, an das Ende des aktuellen StringBuilder-Objekts an.

AppendLine()

Quelle:

StringBuilder.cs

Fügt das Standardzeilenabschlusszeichen am Ende des aktuellen StringBuilder-Objekts an.

public:
 System::Text::StringBuilder ^ AppendLine();

public System.Text.StringBuilder AppendLine ();

member this.AppendLine : unit -> System.Text.StringBuilder

Public Function AppendLine () As StringBuilder

Gibt zurück

StringBuilder

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

ArgumentOutOfRangeException

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Beispiele

Das folgende Beispiel veranschaulicht die AppendLine Methode.

// This example demonstrates the StringBuilder.AppendLine()
// method.

using namespace System;
using namespace System::Text;

int main()
{
    StringBuilder^ sb = gcnew StringBuilder;
    String^ line = L"A line of text.";
    int number = 123;

    // Append two lines of text.
    sb->AppendLine( L"The first line of text." );
    sb->AppendLine( line );

    // Append a new line, an empty string, and a null cast as a string.
    sb->AppendLine();
    sb->AppendLine( L"" );
    sb->AppendLine( L"" );

    // Append the non-string value, 123, and two new lines.
    sb->Append( number )->AppendLine()->AppendLine();

    // Append two lines of text.
    sb->AppendLine( line );
    sb->AppendLine( L"The last line of text." );

    // Convert the value of the StringBuilder to a string and display the string.
    Console::WriteLine( sb );

    return 0;
}

/*
This example produces the following results:

The first line of text.
A line of text.



123

A line of text.
The last line of text.
*/

// This example demonstrates the StringBuilder.AppendLine()
// method.

using System;
using System.Text;

class Sample
{
    public static void Main()
    {
    StringBuilder sb = new StringBuilder();
    string        line = "A line of text.";
    int           number = 123;

// Append two lines of text.
    sb.AppendLine("The first line of text.");
    sb.AppendLine(line);

// Append a new line, an empty string, and a null cast as a string.
    sb.AppendLine();
    sb.AppendLine("");
    sb.AppendLine((string)null);

// Append the non-string value, 123, and two new lines.
    sb.Append(number).AppendLine().AppendLine();

// Append two lines of text.
    sb.AppendLine(line);
    sb.AppendLine("The last line of text.");

// Convert the value of the StringBuilder to a string and display the string.
    Console.WriteLine(sb.ToString());
    }
}
/*
This example produces the following results:

The first line of text.
A line of text.



123

A line of text.
The last line of text.
*/

// This example demonstrates the StringBuilder.AppendLine()
// method.

open System.Text

let sb = StringBuilder()
let line = "A line of text."
let number = 123

// Append two lines of text.
sb.AppendLine "The first line of text." |> ignore
sb.AppendLine line |> ignore

// Append a new line, an empty string, and a null cast as a string.
sb.AppendLine() |> ignore
sb.AppendLine "" |> ignore
sb.AppendLine Unchecked.defaultof<string> |> ignore

// Append the non-string value, 123, and two new lines.
sb.Append(number).AppendLine().AppendLine() |> ignore

// Append two lines of text.
sb.AppendLine line |> ignore
sb.AppendLine "The last line of text." |> ignore

// Convert the value of the StringBuilder to a string and display the string.
printfn $"{sb}"

// This example produces the following results:
//       The first line of text.
//       A line of text.
//
//
//
//       123
//
//       A line of text.
//       The last line of text.

' This example demonstrates the StringBuilder.AppendLine() 
' method.
Imports System.Text

Class Sample
   Public Shared Sub Main()
      Dim sb As New StringBuilder()
      Dim line As String = "A line of text."
      Dim number As Integer = 123
      
      ' Append two lines of text.
      sb.AppendLine("The first line of text.")
      sb.AppendLine(line)
      
      ' Append a new line, an empty string, and a null cast as a string.
      sb.AppendLine()
      sb.AppendLine("")
      sb.AppendLine(CStr(Nothing))
      
      ' Append the non-string value, 123, and two new lines.
      sb.Append(number).AppendLine().AppendLine()
      
      ' Append two lines of text.
      sb.AppendLine(line)
      sb.AppendLine("The last line of text.")
      
      ' Convert the value of the StringBuilder to a string and display the string.
      Console.WriteLine(sb.ToString())
   End Sub
End Class
'
'This example produces the following results:
'
'The first line of text.
'A line of text.
'
'
'
'123
'
'A line of text.
'The last line of text.

Hinweise

Der Standardzeilenabschluss ist der aktuelle Wert der Environment.NewLine Eigenschaft.

Die Kapazität dieser Instanz wird bei Bedarf angepasst.

Hinweise für Aufrufer

Wenn Sie das Objekt in .NET Core und in der .NET Framework 4.0 und höher instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität der StringBuilder Instanz über den Wert ihrer MaxCapacity Eigenschaft hinausgehen. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

• String

AppendLine(String)

Quelle:

StringBuilder.cs

Fügt eine Kopie der angegebenen Zeichenfolge gefolgt vom Standardzeilenabschlusszeichen am Ende des aktuellen StringBuilder-Objekts an.

public:
 System::Text::StringBuilder ^ AppendLine(System::String ^ value);

public System.Text.StringBuilder AppendLine (string? value);

member this.AppendLine : string -> System.Text.StringBuilder

Public Function AppendLine (value As String) As StringBuilder

Parameter

value

String

Die anzufügende Zeichenfolge.

Gibt zurück

StringBuilder

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

Ausnahmen

ArgumentOutOfRangeException

Bei Erhöhung des Werts dieser Instanz würde MaxCapacity überschritten.

Hinweise

Der Standardzeilenabschluss ist der aktuelle Wert der Environment.NewLine Eigenschaft.

Die Kapazität dieser Instanz wird bei Bedarf angepasst.

Hinweise für Aufrufer

Wenn Sie das Objekt in .NET Core und in der .NET Framework 4.0 und höher instanziieren, indem Sie den StringBuilderStringBuilder(Int32, Int32) Konstruktor aufrufen, kann sowohl die Länge als auch die Kapazität der StringBuilder Instanz über den Wert ihrer MaxCapacity Eigenschaft hinausgehen. Dies kann insbesondere auftreten, wenn Sie die Append(String) Methoden und AppendFormat(String, Object) aufrufen, um kleine Zeichenfolgen anzufügen.

Weitere Informationen

• String

AppendLine(StringBuilder+AppendInterpolatedStringHandler)

Quelle:

StringBuilder.cs

Fügt die angegebene interpolierte Zeichenfolge gefolgt vom Standardzeilenabschluss an das Ende des aktuellen StringBuilder-Objekts an.

public:
 System::Text::StringBuilder ^ AppendLine(System::Text::StringBuilder::AppendInterpolatedStringHandler % handler);

public System.Text.StringBuilder AppendLine (ref System.Text.StringBuilder.AppendInterpolatedStringHandler handler);

member this.AppendLine : AppendInterpolatedStringHandler -> System.Text.StringBuilder

Public Function AppendLine (ByRef handler As StringBuilder.AppendInterpolatedStringHandler) As StringBuilder

Parameter

handler

StringBuilder.AppendInterpolatedStringHandler

Die interpolierte Zeichenfolge, die angefügt werden soll.

Gibt zurück

StringBuilder

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.

AppendLine(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Quelle:

StringBuilder.cs

Fügt die angegebene interpolierte Zeichenfolge im angegebenen Format, gefolgt vom Standardzeilenabschluss, an das Ende des aktuellen StringBuilder-Objekts an.

public:
 System::Text::StringBuilder ^ AppendLine(IFormatProvider ^ provider, System::Text::StringBuilder::AppendInterpolatedStringHandler % handler);

public System.Text.StringBuilder AppendLine (IFormatProvider? provider, ref System.Text.StringBuilder.AppendInterpolatedStringHandler handler);

member this.AppendLine : IFormatProvider * AppendInterpolatedStringHandler -> System.Text.StringBuilder

Public Function AppendLine (provider As IFormatProvider, ByRef handler As StringBuilder.AppendInterpolatedStringHandler) As StringBuilder

Parameter

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

handler

StringBuilder.AppendInterpolatedStringHandler

Die interpolierte Zeichenfolge, die angefügt werden soll.

Gibt zurück

StringBuilder

Ein Verweis auf diese Instanz, nachdem der Anfügevorgang abgeschlossen wurde.