StringBuilder.AppendLine Yöntem

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Varsayılan satır sonlandırıcısını veya belirtilen dizenin bir kopyasını ve varsayılan satır sonlandırıcısını bu örneğin sonuna ekler.

Aşırı Yüklemeler

Name	Description
AppendLine()	Varsayılan satır sonlandırıcısını geçerli StringBuilder nesnenin sonuna ekler.
AppendLine(String)	Belirtilen dizenin bir kopyasını ve ardından varsayılan satır sonlandırıcısını geçerli StringBuilder nesnenin sonuna ekler.
AppendLine(StringBuilder+AppendInterpolatedStringHandler)	Belirtilen ilişkilendirilmiş dizeyi ve ardından varsayılan satır sonlandırıcısını geçerli StringBuilder nesnesinin sonuna ekler.
AppendLine(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)	Belirtilen biçimi kullanarak belirtilen ilişkilendirilmiş dizeyi ekler ve ardından varsayılan satır sonlandırıcısını geçerli StringBuilder nesnesinin sonuna ekler.

AppendLine()

Kaynak:

StringBuilder.cs

Varsayılan satır sonlandırıcısını geçerli StringBuilder nesnenin sonuna ekler.

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

public System.Text.StringBuilder AppendLine();

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

Public Function AppendLine () As StringBuilder

Döndürülenler

StringBuilder

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

ArgumentOutOfRangeException

Bu örneğin değerinin büyüyeceği zaman değerini aşmış MaxCapacityolursunuz.

Örnekler

Aşağıdaki örnekte yöntemi gösterilmektedir AppendLine .

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

Açıklamalar

Varsayılan satır sonlandırıcı özelliğin geçerli değeridir Environment.NewLine .

Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerinde oluşturucuyu çağırarak StringBuilder nesnesinin örneğini StringBuilder(Int32, Int32) oluştururken, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerinin ötesine geçebilir. Bu, özellikle küçük dizeleri eklemek için ve Append(String) yöntemlerini çağırdığınızda AppendFormat(String, Object) oluşabilir.

Ayrıca bkz.

• String

AppendLine(String)

Kaynak:

StringBuilder.cs

Belirtilen dizenin bir kopyasını ve ardından varsayılan satır sonlandırıcısını geçerli StringBuilder nesnenin sonuna ekler.

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

Parametreler

value

String

Eklenecek dize.

Döndürülenler

StringBuilder

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

Özel durumlar

ArgumentOutOfRangeException

Bu örneğin değerinin büyüyeceği zaman değerini aşmış MaxCapacityolursunuz.

Açıklamalar

Varsayılan satır sonlandırıcı özelliğin geçerli değeridir Environment.NewLine .

Bu örneğin kapasitesi gerektiği gibi ayarlanır.

Arayanlara Notlar

.NET Core'da ve .NET Framework 4.0 ve sonraki sürümlerinde oluşturucuyu çağırarak StringBuilder nesnesinin örneğini StringBuilder(Int32, Int32) oluştururken, örneğin hem uzunluğu hem de kapasitesi StringBuilder özelliğinin MaxCapacity değerinin ötesine geçebilir. Bu, özellikle küçük dizeleri eklemek için ve Append(String) yöntemlerini çağırdığınızda AppendFormat(String, Object) oluşabilir.

Ayrıca bkz.

• String

AppendLine(StringBuilder+AppendInterpolatedStringHandler)

Kaynak:

StringBuilder.cs

Belirtilen ilişkilendirilmiş dizeyi ve ardından varsayılan satır sonlandırıcısını geçerli StringBuilder nesnesinin sonuna ekler.

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

Parametreler

handler

StringBuilder.AppendInterpolatedStringHandler

Eklenecek ilişkilendirilmiş dize.

Döndürülenler

StringBuilder

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.

AppendLine(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

Kaynak:

StringBuilder.cs

Belirtilen biçimi kullanarak belirtilen ilişkilendirilmiş dizeyi ekler ve ardından varsayılan satır sonlandırıcısını geçerli StringBuilder nesnesinin sonuna ekler.

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

Parametreler

provider

IFormatProvider

Kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.

handler

StringBuilder.AppendInterpolatedStringHandler

Eklenecek ilişkilendirilmiş dize.

Döndürülenler

StringBuilder

Ekleme işlemi tamamlandıktan sonra bu örneğe başvuru.