StringBuilder.AppendLine Methode

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

Een verwijzing naar dit exemplaar nadat de toevoegbewerking is voltooid.

Kenmerken

ComVisibleAttribute

Uitzonderingen

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

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

Retouren

Een verwijzing naar dit exemplaar nadat de toevoegbewerking is voltooid.

Kenmerken

ComVisibleAttribute

Uitzonderingen

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