StringBuilder.AppendLine 메서드

참조

정의

네임스페이스:: System.Text

어셈블리:: System.Runtime.dll

어셈블리:: netstandard.dll

어셈블리:: mscorlib.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

이 인스턴스의 끝에 기본 줄 종결자 또는 지정한 문자열의 복사본과 기본 줄 종결자를 추가합니다.

오버로드

AppendLine()	현재 StringBuilder 개체의 끝에 기본 줄 종결자를 추가합니다.
AppendLine(String)	현재 StringBuilder 개체의 끝에 지정한 문자열의 복사본과 기본 줄 종결자를 차례로 추가합니다.
AppendLine(StringBuilder+AppendInterpolatedStringHandler)	지정 된 보간된 문자열 뒤에 기본 줄 종결자를 추가 하 여 현재 StringBuilder 개체의 끝에 추가 합니다.
AppendLine(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)	지정 된 형식을 사용 하 여 지정 된 보간된 문자열 뒤에 기본 줄 종결자를 추가 하 여 현재 StringBuilder 개체의 끝에 추가 합니다.

AppendLine()

현재 StringBuilder 개체의 끝에 기본 줄 종결자를 추가합니다.

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

반환

StringBuilder

추가 작업이 완료된 후 이 인스턴스에 대한 참조입니다.

특성: ComVisibleAttribute

예외

ArgumentOutOfRangeException

이 인스턴스의 값이 커지면 MaxCapacity가 초과됩니다.

예제

다음 예제는 AppendLine 메서드.

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

이 인스턴스의 용량은 필요에 따라 조정 됩니다.

호출자 참고

.net Core 및 .NET Framework 4.0 이상 버전에서 StringBuilder 생성자를 호출 하 여 개체를 인스턴스화하면 StringBuilder(Int32, Int32) 인스턴스의 길이와 용량이 모두 StringBuilder 해당 속성의 값을 초과 하 여 커질 수 있습니다 MaxCapacity . 이는 특히 및 메서드를 호출 하 여 Append(String) 작은 문자열을 추가 하는 경우에 발생할 수 있습니다 AppendFormat(String, Object) .

추가 정보

String

적용 대상

AppendLine(String)

현재 StringBuilder 개체의 끝에 지정한 문자열의 복사본과 기본 줄 종결자를 차례로 추가합니다.

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

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

매개 변수

value: String

추가할 문자열입니다.

반환

StringBuilder

추가 작업이 완료된 후 이 인스턴스에 대한 참조입니다.

특성: ComVisibleAttribute

예외

ArgumentOutOfRangeException

이 인스턴스의 값이 커지면 MaxCapacity가 초과됩니다.

설명

기본 줄 종결자는 속성의 현재 값입니다 Environment.NewLine .

이 인스턴스의 용량은 필요에 따라 조정 됩니다.

호출자 참고

추가 정보

String

적용 대상

AppendLine(StringBuilder+AppendInterpolatedStringHandler)

지정 된 보간된 문자열 뒤에 기본 줄 종결자를 추가 하 여 현재 StringBuilder 개체의 끝에 추가 합니다.

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

매개 변수

handler: StringBuilder.AppendInterpolatedStringHandler

추가할 보간된 문자열입니다.

반환

StringBuilder

추가 작업이 완료된 후 이 인스턴스에 대한 참조입니다.

적용 대상

AppendLine(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

지정 된 형식을 사용 하 여 지정 된 보간된 문자열 뒤에 기본 줄 종결자를 추가 하 여 현재 StringBuilder 개체의 끝에 추가 합니다.

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

매개 변수

provider: IFormatProvider

문화권별 형식 정보를 제공하는 개체입니다.

handler: StringBuilder.AppendInterpolatedStringHandler

추가할 보간된 문자열입니다.

반환

StringBuilder

추가 작업이 완료된 후 이 인스턴스에 대한 참조입니다.

적용 대상

StringBuilder.AppendLine 메서드

정의

오버로드

AppendLine()

반환

예외

예제

설명

호출자 참고

추가 정보

적용 대상

AppendLine(String)

매개 변수

반환

예외

설명

호출자 참고

추가 정보

적용 대상

AppendLine(StringBuilder+AppendInterpolatedStringHandler)

매개 변수

반환

적용 대상

AppendLine(IFormatProvider, StringBuilder+AppendInterpolatedStringHandler)

매개 변수

반환

적용 대상

추가 리소스