StringBuilder.AppendLine Methode

Referenz

Definition

Namespace:: System.Text

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

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

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

public System.Text.StringBuilder AppendLine ();

[System.Runtime.InteropServices.ComVisible(false)]
public System.Text.StringBuilder AppendLine ();

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

[<System.Runtime.InteropServices.ComVisible(false)>]
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.

Attribute: ComVisibleAttribute

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 StringBuilder StringBuilder(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

Gilt für:

AppendLine(String)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

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);

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

[System.Runtime.InteropServices.ComVisible(false)]
public System.Text.StringBuilder AppendLine (string value);

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

[<System.Runtime.InteropServices.ComVisible(false)>]
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.

Attribute: ComVisibleAttribute

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

Weitere Informationen

String

Gilt für:

AppendLine(StringBuilder+AppendInterpolatedStringHandler)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

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.

Gilt für:

AppendLine(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Quelle:: StringBuilder.cs

Quelle:: StringBuilder.cs

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.

Gilt für:

Freigeben über

StringBuilder.AppendLine Methode

Definition

Überlädt

AppendLine()

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Hinweise für Aufrufer

Weitere Informationen

Gilt für:

AppendLine(String)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Hinweise für Aufrufer

Weitere Informationen

Gilt für:

AppendLine(StringBuilder+AppendInterpolatedStringHandler)

Parameter

Gibt zurück

Gilt für:

AppendLine(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Parameter

Gibt zurück

Gilt für:

Zusätzliche Ressourcen