다음을 통해 공유


StringBuilder 생성자

정의

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

오버로드

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
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 StringBuilder();
public StringBuilder ();
Public Sub New ()

예제

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

StringBuilder^ stringBuilder = gcnew StringBuilder;
StringBuilder stringBuilder = new StringBuilder();
let stringBuilder = StringBuilder()
Dim stringBuilder As New StringBuilder

설명

이 instance 문자열 값은 로 String.Empty설정되고 용량은 구현별 기본 용량으로 설정됩니다.

적용 대상

StringBuilder(Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
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

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

예외

capacity가 0보다 작은 경우

예제

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

int capacity = 255;
StringBuilder^ stringBuilder = gcnew StringBuilder( capacity );
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 현재 instance 할당한 메모리에 저장할 수 있는 최대 문자 수를 정의합니다. 해당 값은 속성에 Capacity 할당됩니다. 현재 instance 저장할 문자 수가 이 capacity 값을 초과하면 개체는 StringBuilder 추가 메모리를 할당하여 저장합니다.

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

추가 정보

적용 대상

StringBuilder(String)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 StringBuilder(System::String ^ value);
public StringBuilder (string value);
public StringBuilder (string? value);
new System.Text.StringBuilder : string -> System.Text.StringBuilder
Public Sub New (value As String)

매개 변수

value
String

인스턴스 값을 초기화하는 데 사용되는 문자열입니다. valuenull이면 새 StringBuilder에 빈 문자열(Empty)이 포함됩니다.

예제

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

String^ initialString = L"Initial string.";
StringBuilder^ stringBuilder = gcnew StringBuilder( initialString );
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)

설명

valuenull이면 새 StringBuilder에 빈 문자열(Empty)이 포함됩니다.

적용 대상

StringBuilder(Int32, Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
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

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

예외

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

예제

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

int capacity = 255;
int maxCapacity = 1024;
StringBuilder^ stringBuilder = gcnew StringBuilder( capacity,maxCapacity );
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 현재 instance 할당한 메모리에 저장할 수 있는 최대 문자 수를 정의합니다. 해당 값은 속성에 Capacity 할당됩니다. 현재 instance 저장할 문자 수가 이 capacity 값을 초과하면 개체는 StringBuilder 추가 메모리를 할당하여 저장합니다.

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

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

호출자 참고

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

추가 정보

적용 대상

StringBuilder(String, Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
Source:
StringBuilder.cs

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

public:
 StringBuilder(System::String ^ value, int capacity);
public StringBuilder (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

인스턴스 값을 초기화하는 데 사용되는 문자열입니다. valuenull이면 새 StringBuilder에 빈 문자열(Empty)이 포함됩니다.

capacity
Int32

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

예외

capacity가 0보다 작은 경우

예제

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

String^ initialString = L"Initial string. ";
int capacity = 255;
StringBuilder^ stringBuilder = gcnew StringBuilder(
   initialString,capacity );
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 현재 instance 할당한 메모리에 저장할 수 있는 최대 문자 수를 정의합니다. 해당 값은 속성에 Capacity 할당됩니다. 현재 instance 저장할 문자 수가 이 capacity 값을 초과하면 개체는 StringBuilder 추가 메모리를 할당하여 저장합니다.

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

추가 정보

적용 대상

StringBuilder(String, Int32, Int32, Int32)

Source:
StringBuilder.cs
Source:
StringBuilder.cs
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);
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

이 인스턴스 값을 초기화하는 데 사용된 부분 문자열이 포함된 문자열입니다. valuenull이면 새 StringBuilder에 빈 문자열(Empty)이 포함됩니다.

startIndex
Int32

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

length
Int32

부분 문자열에 있는 문자의 수입니다.

capacity
Int32

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

예외

capacity가 0보다 작은 경우

또는

startIndex+lengthvalue 내의 위치가 아닙니다.

예제

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

String^ initialString = L"Initial string for stringbuilder.";
int startIndex = 0;
int substringLength = 14;
int capacity = 255;
StringBuilder^ stringBuilder = gcnew StringBuilder(
   initialString,startIndex,substringLength,capacity );
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 현재 instance 할당한 메모리에 저장할 수 있는 최대 문자 수를 정의합니다. 해당 값은 속성에 Capacity 할당됩니다. 현재 instance 저장할 문자 수가 이 capacity 값을 초과하면 개체는 StringBuilder 추가 메모리를 할당하여 저장합니다.

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

추가 정보

적용 대상