StringBuilder.AppendLine 메서드

정의

이 인스턴스의 끝에 기본 줄 종결자 또는 지정한 문자열의 복사본과 기본 줄 종결자를 추가합니다.Appends the default line terminator, or a copy of a specified string and the default line terminator, to the end of this instance.

오버로드

AppendLine()

현재 StringBuilder 개체의 끝에 기본 줄 종결자를 추가합니다.Appends the default line terminator to the end of the current StringBuilder object.

AppendLine(String)

현재 StringBuilder 개체의 끝에 지정한 문자열의 복사본과 기본 줄 종결자를 차례로 추가합니다.Appends a copy of the specified string followed by the default line terminator to the end of the current StringBuilder object.

AppendLine()

현재 StringBuilder 개체의 끝에 기본 줄 종결자를 추가합니다.Appends the default line terminator to the end of the current StringBuilder object.

public:
 System::Text::StringBuilder ^ AppendLine();
[System.Runtime.InteropServices.ComVisible(false)]
public System.Text.StringBuilder AppendLine ();
member this.AppendLine : unit -> System.Text.StringBuilder
Public Function AppendLine () As StringBuilder

반환

추가 작업이 완료된 후 이 인스턴스에 대한 참조입니다.A reference to this instance after the append operation has completed.

특성

예외

이 인스턴스의 값이 커지면 MaxCapacity가 초과됩니다.Enlarging the value of this instance would exceed MaxCapacity.

예제

다음 예제는 AppendLine 메서드.The following example demonstrates the AppendLine method.

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

설명

기본 줄 종결자는 Environment.NewLine 속성의 현재 값입니다.The default line terminator is the current value of the Environment.NewLine property.

이 인스턴스의 용량에는 필요에 따라 조정 됩니다.The capacity of this instance is adjusted as needed.

호출자 참고

.NET Core 및 .NET Framework 4.0 이상 버전에서 StringBuilder(Int32, Int32) 생성자를 호출 하 여 StringBuilder 개체를 인스턴스화하면 StringBuilder 인스턴스의 길이와 용량이 모두 해당 MaxCapacity 속성의 값 보다 커질 수 있습니다.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 이는 특히 Append(String)를 호출 하 고 AppendFormat(String, Object) 메서드를 호출 하 여 작은 문자열을 추가할 때 발생할 수 있습니다.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

추가 정보

AppendLine(String)

현재 StringBuilder 개체의 끝에 지정한 문자열의 복사본과 기본 줄 종결자를 차례로 추가합니다.Appends a copy of the specified string followed by the default line terminator to the end of the current StringBuilder object.

public:
 System::Text::StringBuilder ^ AppendLine(System::String ^ value);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Text.StringBuilder AppendLine (string value);
member this.AppendLine : string -> System.Text.StringBuilder
Public Function AppendLine (value As String) As StringBuilder

매개 변수

value
String

추가할 문자열입니다.The string to append.

반환

추가 작업이 완료된 후 이 인스턴스에 대한 참조입니다.A reference to this instance after the append operation has completed.

특성

예외

이 인스턴스의 값이 커지면 MaxCapacity가 초과됩니다.Enlarging the value of this instance would exceed MaxCapacity.

설명

기본 줄 종결자는 Environment.NewLine 속성의 현재 값입니다.The default line terminator is the current value of the Environment.NewLine property.

이 인스턴스의 용량에는 필요에 따라 조정 됩니다.The capacity of this instance is adjusted as needed.

호출자 참고

.NET Core 및 .NET Framework 4.0 이상 버전에서 StringBuilder(Int32, Int32) 생성자를 호출 하 여 StringBuilder 개체를 인스턴스화하면 StringBuilder 인스턴스의 길이와 용량이 모두 해당 MaxCapacity 속성의 값 보다 커질 수 있습니다.In .NET Core and in the .NET Framework 4.0 and later versions, when you instantiate the StringBuilder object by calling the StringBuilder(Int32, Int32) constructor, both the length and the capacity of the StringBuilder instance can grow beyond the value of its MaxCapacity property. 이는 특히 Append(String)를 호출 하 고 AppendFormat(String, Object) 메서드를 호출 하 여 작은 문자열을 추가할 때 발생할 수 있습니다.This can occur particularly when you call the Append(String) and AppendFormat(String, Object) methods to append small strings.

추가 정보

적용 대상