StringBuilder.AppendLine Methode

Definitie

Naamruimte:: System.Text

Assembly's:: mscorlib.dll, System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Voegt het standaardregeleindteken of een kopie van een opgegeven tekenreeks en het standaardregeleindteken toe aan het einde van dit exemplaar.

Overloads

Name	Description
AppendLine()	Hiermee voegt u de standaardregeleindteken toe aan het einde van het huidige StringBuilder object.
AppendLine(String)	Voegt een kopie van de opgegeven tekenreeks toe, gevolgd door het standaardregeleindteken aan het einde van het huidige StringBuilder object.

AppendLine()

Hiermee voegt u de standaardregeleindteken toe aan het einde van het huidige StringBuilder object.

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

Retouren

StringBuilder

Een verwijzing naar dit exemplaar nadat de toevoegbewerking is voltooid.

Kenmerken: ComVisibleAttribute

Uitzonderingen

ArgumentOutOfRangeException

Het vergroten van de waarde van dit exemplaar zou groter zijn dan MaxCapacity.

Voorbeelden

In het volgende voorbeeld ziet u de AppendLine methode.

// 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.

Opmerkingen

De standaardregeleindteken is de huidige waarde van de Environment.NewLine eigenschap.

De capaciteit van dit exemplaar wordt naar behoefte aangepast.

Notities voor bellers

Wanneer u in .NET Core en in de .NET Framework 4.0- en latere versies het StringBuilder-object instantiëren door de constructor StringBuilder(Int32, Int32) aan te roepen, kan zowel de lengte als de capaciteit van het StringBuilder-exemplaar groter worden dan de waarde van de eigenschap MaxCapacity. Dit kan met name gebeuren wanneer u de Append(String) en AppendFormat(String, Object) methoden aanroept om kleine tekenreeksen toe te voegen.

Zie ook

String

Van toepassing op

AppendLine(String)

Voegt een kopie van de opgegeven tekenreeks toe, gevolgd door het standaardregeleindteken aan het einde van het huidige StringBuilder object.

public:
 System::Text::StringBuilder ^ AppendLine(System::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

Parameters

value: String

De tekenreeks die moet worden toegevoegd.