StringBuilder.AppendLine Metode

Definisi

Ruang nama:

System.Text

Rakitan:

netstandard.dll, System.Runtime.dll

Menambahkan terminator baris default, atau salinan string tertentu dan terminator baris default, ke akhir instans ini.

Overload

Nama	Deskripsi
AppendLine()	Menambahkan terminator baris default ke akhir objek saat ini StringBuilder .
AppendLine(String)	Menambahkan salinan string yang ditentukan diikuti oleh terminator baris default ke akhir objek saat ini StringBuilder .
AppendLine(StringBuilder+AppendInterpolatedStringHandler)	Menambahkan string terinterpolasi yang ditentukan diikuti oleh terminator baris default ke akhir objek StringBuilder saat ini.
AppendLine(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)	Menambahkan string terinterpolasi yang ditentukan menggunakan format yang ditentukan, diikuti oleh terminator baris default, ke akhir objek StringBuilder saat ini.

AppendLine()

Sumber:

StringBuilder.cs

Menambahkan terminator baris default ke akhir objek saat ini StringBuilder .

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

public System.Text.StringBuilder AppendLine();

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

Public Function AppendLine () As StringBuilder

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampingan selesai.

Pengecualian

ArgumentOutOfRangeException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Contoh

Contoh berikut menunjukkan AppendLine metode .

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

Keterangan

Terminator baris default adalah nilai Environment.NewLine properti saat ini.

Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Di .NET Core dan di .NET Framework 4.0 dan versi yang lebih baru, ketika Anda membuat StringBuilder instans objek dengan memanggil StringBuilder(Int32, Int32) konstruktor, panjang dan kapasitas StringBuilder instans dapat tumbuh di luar nilai propertinya MaxCapacity . Ini dapat terjadi terutama ketika Anda memanggil Append(String) metode dan AppendFormat(String, Object) untuk menambahkan string kecil.

Lihat juga

• String

AppendLine(String)

Sumber:

StringBuilder.cs

Menambahkan salinan string yang ditentukan diikuti oleh terminator baris default ke akhir objek saat ini StringBuilder .

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

String yang akan ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampingan selesai.

Pengecualian

ArgumentOutOfRangeException

Memperbesar nilai instans ini akan melebihi MaxCapacity.

Keterangan

Terminator baris default adalah nilai Environment.NewLine properti saat ini.

Kapasitas instans ini disesuaikan sesuai kebutuhan.

Catatan Bagi Pemanggil

Di .NET Core dan di .NET Framework 4.0 dan versi yang lebih baru, ketika Anda membuat StringBuilder instans objek dengan memanggil StringBuilder(Int32, Int32) konstruktor, panjang dan kapasitas StringBuilder instans dapat tumbuh di luar nilai propertinya MaxCapacity . Ini dapat terjadi terutama ketika Anda memanggil Append(String) metode dan AppendFormat(String, Object) untuk menambahkan string kecil.

Lihat juga

• String

AppendLine(StringBuilder+AppendInterpolatedStringHandler)

Sumber:

StringBuilder.cs

Menambahkan string terinterpolasi yang ditentukan diikuti oleh terminator baris default ke akhir objek StringBuilder saat ini.

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

String terinterpolasi untuk ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampingan selesai.

AppendLine(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Sumber:

StringBuilder.cs

Menambahkan string terinterpolasi yang ditentukan menggunakan format yang ditentukan, diikuti oleh terminator baris default, ke akhir objek StringBuilder saat ini.

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

Objek yang memasok informasi pemformatan khusus budaya.

handler

StringBuilder.AppendInterpolatedStringHandler

String terinterpolasi untuk ditambahkan.

Mengembalikan

StringBuilder

Referensi ke instans ini setelah operasi penampingan selesai.