StringBuilder 생성자

정의

네임스페이스:

System.Text

어셈블리:

netstandard.dll, System.Runtime.dll

StringBuilder 클래스의 새 인스턴스를 초기화합니다.

오버로드

Name	Description
StringBuilder()	StringBuilder 클래스의 새 인스턴스를 초기화합니다.
StringBuilder(Int32)	지정된 용량을 사용하여 클래스의 StringBuilder 새 인스턴스를 초기화합니다.
StringBuilder(String)	지정된 문자열을 사용하여 클래스의 StringBuilder 새 인스턴스를 초기화합니다.
StringBuilder(Int32, Int32)	지정된 용량으로 시작하여 지정된 최대 용량으로 확장할 수 있는 클래스의 StringBuilder 새 인스턴스를 초기화합니다.
StringBuilder(String, Int32)	지정된 문자열 및 용량을 StringBuilder 사용하여 클래스의 새 인스턴스를 초기화합니다.
StringBuilder(String, Int32, Int32, Int32)	지정된 부분 문자열 및 용량에서 클래스의 StringBuilder 새 인스턴스를 초기화합니다.

StringBuilder()

Source:

StringBuilder.cs

StringBuilder 클래스의 새 인스턴스를 초기화합니다.

public:
 StringBuilder();

public StringBuilder();

Public Sub New ()

예제

다음 예제에서는 매개 변수 없이 생성자를 호출 StringBuilder 하는 방법을 보여 줍니다.

StringBuilder stringBuilder = new StringBuilder();

let stringBuilder = StringBuilder()

Dim stringBuilder As New StringBuilder

설명

이 인스턴스의 문자열 값은 />로 설정되고 용량은 구현별 기본 용량으로 설정됩니다.

StringBuilder(Int32)

Source:

StringBuilder.cs

지정된 용량을 사용하여 클래스의 StringBuilder 새 인스턴스를 초기화합니다.

public:
 StringBuilder(int capacity);

public StringBuilder(int capacity);

new System.Text.StringBuilder : int -> System.Text.StringBuilder

Public Sub New (capacity As Integer)

매개 변수

capacity

Int32

이 인스턴스의 제안된 시작 크기입니다.

예외

ArgumentOutOfRangeException

capacity가 0보다 작습니다.

예제

다음 예제에서는 지정된 용량으로 StringBuilder 생성자를 호출하는 방법을 보여 줍니다.

int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(capacity);

let capacity = 255
let stringBuilder = StringBuilder capacity

Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(capacity)

설명

매개 변수는 capacity 현재 인스턴스에서 할당한 메모리에 저장할 수 있는 최대 문자 수를 정의합니다. 해당 값은 속성에 Capacity 할당됩니다. 현재 인스턴스에 저장할 문자 수가 이 capacity 값을 초과하면 개체는 StringBuilder 저장할 추가 메모리를 할당합니다.

이 인스턴스의 문자열 값은 .로 설정됩니다 String.Empty. 0이면 capacity 구현별 기본 용량이 사용됩니다.

추가 정보

• Capacity

StringBuilder(String)

Source:

StringBuilder.cs

지정된 문자열을 사용하여 클래스의 StringBuilder 새 인스턴스를 초기화합니다.

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

public StringBuilder(string? value);

new System.Text.StringBuilder : string -> System.Text.StringBuilder

Public Sub New (value As String)

매개 변수

value

String

인스턴스 값을 초기화하는 데 사용되는 문자열입니다. 이 null경우 value 새 StringBuilder 항목에는 빈 문자열(즉, 포함)이 포함됩니다Empty.

예제

다음 예제에서는 지정된 문자열을 StringBuilder 사용하여 생성자를 호출하는 방법을 보여 줍니다.

string initialString = "Initial string.";
StringBuilder stringBuilder = new StringBuilder(initialString);

let initialString = "Initial string."
let stringBuilder = StringBuilder initialString

Dim initialString As String = "Initial string."
Dim stringBuilder As New StringBuilder(initialString)

설명

이 null경우 value 새 StringBuilder 항목에는 빈 문자열(즉, 포함)이 포함됩니다Empty.

StringBuilder(Int32, Int32)

Source:

StringBuilder.cs

지정된 용량으로 시작하여 지정된 최대 용량으로 확장할 수 있는 클래스의 StringBuilder 새 인스턴스를 초기화합니다.

public:
 StringBuilder(int capacity, int maxCapacity);

public StringBuilder(int capacity, int maxCapacity);

new System.Text.StringBuilder : int * int -> System.Text.StringBuilder

Public Sub New (capacity As Integer, maxCapacity As Integer)

매개 변수

capacity

Int32

의 제안된 시작 크기입니다 StringBuilder.

maxCapacity

Int32

현재 문자열에 포함될 수 있는 최대 문자 수입니다.

예외

ArgumentOutOfRangeException

maxCapacity 가 1보다 작거나, capacity 0보다 작거나 capacity , 보다 maxCapacity큽니다.

예제

다음 예제에서는 지정된 용량과 최대 용량을 StringBuilder 사용하여 생성자를 호출하는 방법을 보여 줍니다.

int capacity = 255;
int maxCapacity = 1024;
StringBuilder stringBuilder = 
    new StringBuilder(capacity, maxCapacity);

let capacity = 255
let maxCapacity = 1024
let stringBuilder = StringBuilder(capacity, maxCapacity)

Dim capacity As Integer = 255
Dim maxCapacity As Integer = 1024
Dim stringBuilder As New StringBuilder(capacity, maxCapacity)

설명

매개 변수는 capacity 현재 인스턴스에서 할당한 메모리에 저장할 수 있는 최대 문자 수를 정의합니다. 해당 값은 속성에 Capacity 할당됩니다. 현재 인스턴스에 저장할 문자 수가 이 capacity 값을 초과하면 개체는 StringBuilder 저장할 추가 메모리를 할당합니다.

0이면 capacity 구현별 기본 용량이 사용됩니다.

이 속성은 maxCapacity 현재 인스턴스에서 보유할 수 있는 최대 문자 수를 정의합니다. 해당 값은 속성에 MaxCapacity 할당됩니다. 현재 인스턴스에 저장할 문자 수가 이 maxCapacity 값을 초과하면 개체는 추가 메모리를 StringBuilder 할당하지 않고 대신 예외를 throw합니다.

호출자 참고

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

추가 정보

• Capacity
• MaxCapacity

StringBuilder(String, Int32)

Source:

StringBuilder.cs

지정된 문자열 및 용량을 StringBuilder 사용하여 클래스의 새 인스턴스를 초기화합니다.

public:
 StringBuilder(System::String ^ value, int capacity);

public StringBuilder(string? value, int capacity);

new System.Text.StringBuilder : string * int -> System.Text.StringBuilder

Public Sub New (value As String, capacity As Integer)

매개 변수

value

String

인스턴스 값을 초기화하는 데 사용되는 문자열입니다. 이 null경우 value 새 StringBuilder 항목에는 빈 문자열(즉, 포함)이 포함됩니다Empty.

capacity

Int32

의 제안된 시작 크기입니다 StringBuilder.

예외

ArgumentOutOfRangeException

capacity가 0보다 작습니다.

예제

다음 예제에서는 초기 문자열 및 지정된 용량을 사용하여 생성자를 호출 StringBuilder 하는 방법을 보여 줍니다.

string initialString = "Initial string. ";
int capacity = 255;
StringBuilder stringBuilder = 
    new StringBuilder(initialString, capacity);

let initialString = "Initial string. "
let capacity = 255
let stringBuilder = StringBuilder(initialString, capacity)

Dim initialString As String = "Initial string. "
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(initialString, capacity)

설명

매개 변수는 capacity 현재 인스턴스에서 할당한 메모리에 저장할 수 있는 최대 문자 수를 정의합니다. 해당 값은 속성에 Capacity 할당됩니다. 현재 인스턴스에 저장할 문자 수가 이 capacity 값을 초과하면 개체는 StringBuilder 저장할 추가 메모리를 할당합니다.

0이면 capacity 구현별 기본 용량이 사용됩니다.

추가 정보

• Capacity

StringBuilder(String, Int32, Int32, Int32)

Source:

StringBuilder.cs

지정된 부분 문자열 및 용량에서 클래스의 StringBuilder 새 인스턴스를 초기화합니다.

public:
 StringBuilder(System::String ^ value, int startIndex, int length, int capacity);

public StringBuilder(string? value, int startIndex, int length, int capacity);

new System.Text.StringBuilder : string * int * int * int -> System.Text.StringBuilder

Public Sub New (value As String, startIndex As Integer, length As Integer, capacity As Integer)

매개 변수

value

String

이 인스턴스의 값을 초기화하는 데 사용되는 부분 문자열을 포함하는 문자열입니다. 이 null경우 value 새 StringBuilder 항목에는 빈 문자열(즉, 포함)이 포함됩니다Empty.

startIndex

Int32

value 부분 문자열이 시작되는 위치입니다.

length

Int32

부분 문자열의 문자 수입니다.

capacity

Int32

의 제안된 시작 크기입니다 StringBuilder.

예외

ArgumentOutOfRangeException

capacity가 0보다 작습니다.

-또는-

startIndex더하기 length 는 .value

예제

다음 예제에서는 지정된 문자열을 StringBuilder 사용하여 생성자를 호출하는 방법을 보여 줍니다.

string initialString = "Initial string for stringbuilder.";
int startIndex = 0;
int substringLength = 14;
int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(initialString, 
    startIndex, substringLength, capacity);

let initialString = "Initial string for stringbuilder."
let startIndex = 0
let substringLength = 14
let capacity = 255

let stringBuilder =
    StringBuilder(initialString, startIndex, substringLength, capacity)

Dim initialString As String = "Initial string for stringbuilder."
Dim startIndex As Integer = 0
Dim substringLength As Integer = 14
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(initialString, _
    startIndex, substringLength, capacity)

설명

매개 변수는 capacity 현재 인스턴스에서 할당한 메모리에 저장할 수 있는 최대 문자 수를 정의합니다. 해당 값은 속성에 Capacity 할당됩니다. 현재 인스턴스에 저장할 문자 수가 이 capacity 값을 초과하면 개체는 StringBuilder 저장할 추가 메모리를 할당합니다.

0이면 capacity 구현별 기본 용량이 사용됩니다.

추가 정보

• Capacity