StringBuilder StringBuilder StringBuilder StringBuilder Constructors

정의

오버로드

StringBuilder() StringBuilder() StringBuilder()

StringBuilder 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the StringBuilder class.

StringBuilder(Int32) StringBuilder(Int32) StringBuilder(Int32) StringBuilder(Int32)

지정된 용량을 사용하여 StringBuilder 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the StringBuilder class using the specified capacity.

StringBuilder(String) StringBuilder(String) StringBuilder(String) StringBuilder(String)

지정된 문자열을 사용하여 StringBuilder 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the StringBuilder class using the specified string.

StringBuilder(Int32, Int32) StringBuilder(Int32, Int32) StringBuilder(Int32, Int32) StringBuilder(Int32, Int32)

지정된 용량으로 시작되어 지정된 최대 용량까지 커질 수 있는 StringBuilder 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the StringBuilder class that starts with a specified capacity and can grow to a specified maximum.

StringBuilder(String, Int32) StringBuilder(String, Int32) StringBuilder(String, Int32) StringBuilder(String, Int32)

지정된 문자열과 용량을 사용하여 StringBuilder 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the StringBuilder class using the specified string and capacity.

StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32)

지정된 부분 문자열과 용량을 사용하여 StringBuilder 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the StringBuilder class from the specified substring and capacity.

StringBuilder() StringBuilder() StringBuilder()

StringBuilder 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the StringBuilder class.

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

예제

다음 예제에서는 호출 하는 방법에 설명 합니다 StringBuilder 매개 변수가 없는 생성자입니다.The following example demonstrates how to call the StringBuilder constructor with no parameters.

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

설명

이 인스턴스의 문자열 값 설정할지 String.Empty, 용량 구현 별 기본 용량으로 설정 됩니다.The string value of this instance is set to String.Empty, and the capacity is set to the implementation-specific default capacity.

StringBuilder(Int32) StringBuilder(Int32) StringBuilder(Int32) StringBuilder(Int32)

지정된 용량을 사용하여 StringBuilder 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the StringBuilder class using the specified capacity.

public:
 StringBuilder(int capacity);
public StringBuilder (int capacity);
new System.Text.StringBuilder : int -> System.Text.StringBuilder
Public Sub New (capacity As Integer)

매개 변수

capacity
Int32 Int32 Int32 Int32

이 인스턴스의 제안된 시작 크기입니다.The suggested starting size of this instance.

예외

예제

다음 예제에서는 호출 하는 방법에 설명 합니다 StringBuilder 생성자는 지정 된 용량을 사용 합니다.The following example demonstrates how to call the StringBuilder constructor with a specified capacity.

int capacity = 255;
StringBuilder^ stringBuilder = gcnew StringBuilder( capacity );
int capacity = 255;
StringBuilder stringBuilder = new StringBuilder(capacity);
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(capacity)

설명

capacity 매개 변수는 현재 인스턴스에 의해 할당 된 메모리에 저장할 수 있는 문자의 최대 수를 정의 합니다.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. 해당 값이 할당 된 Capacity 속성입니다.Its value is assigned to the Capacity property. 현재 인스턴스에 저장 될 문자 수가이 초과 하는 경우 capacity 값을 StringBuilder 개체를 저장할 추가 메모리를 할당 합니다.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

이 인스턴스의 문자열 값 설정할지 String.Empty합니다.The string value of this instance is set to String.Empty. 경우 capacity 이 0 인 구현 별 기본 용량을 사용 합니다.If capacity is zero, the implementation-specific default capacity is used.

추가 정보

StringBuilder(String) StringBuilder(String) StringBuilder(String) StringBuilder(String)

지정된 문자열을 사용하여 StringBuilder 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the StringBuilder class using the specified string.

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 String String String

인스턴스 값을 초기화하는 데 사용되는 문자열입니다.The string used to initialize the value of the instance. valuenull이면 새 StringBuilder에 빈 문자열(Empty)이 포함됩니다.If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

예제

다음 예제에서는 호출 하는 방법에 설명 합니다 StringBuilder 지정된 된 문자열을 사용 하 여 생성자입니다.The following example demonstrates how to call the StringBuilder constructor with the specified string.

String^ initialString = L"Initial string.";
StringBuilder^ stringBuilder = gcnew StringBuilder( initialString );
string initialString = "Initial string.";
StringBuilder stringBuilder = new StringBuilder(initialString);
Dim initialString As String = "Initial string."
Dim stringBuilder As New StringBuilder(initialString)

설명

valuenull이면 새 StringBuilder에 빈 문자열(Empty)이 포함됩니다.If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

StringBuilder(Int32, Int32) StringBuilder(Int32, Int32) StringBuilder(Int32, Int32) StringBuilder(Int32, Int32)

지정된 용량으로 시작되어 지정된 최대 용량까지 커질 수 있는 StringBuilder 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the StringBuilder class that starts with a specified capacity and can grow to a specified maximum.

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 Int32 Int32 Int32

StringBuilder의 제안된 시작 크기입니다.The suggested starting size of the StringBuilder.

maxCapacity
Int32 Int32 Int32 Int32

현재 문자열에 포함할 수 있는 최대 문자 수입니다.The maximum number of characters the current string can contain.

예외

maxCapacity가 1보다 작거나, capacity가 0보다 작거나, capacitymaxCapacity보다 큽니다.maxCapacity is less than one, capacity is less than zero, or capacity is greater than maxCapacity.

예제

다음 예제에서는 호출 하는 방법에 설명 합니다 StringBuilder 지정 된 용량 및 최대 용량을 사용 하 여 생성자입니다.The following example demonstrates how to call the StringBuilder constructor with a specified capacity and maximum capacity.

int capacity = 255;
int maxCapacity = 1024;
StringBuilder^ stringBuilder = gcnew StringBuilder( capacity,maxCapacity );
int capacity = 255;
int maxCapacity = 1024;
StringBuilder stringBuilder = 
    new StringBuilder(capacity, maxCapacity);
Dim capacity As Integer = 255
Dim maxCapacity As Integer = 1024
Dim stringBuilder As New StringBuilder(capacity, maxCapacity)

설명

capacity 매개 변수는 현재 인스턴스에 의해 할당 된 메모리에 저장할 수 있는 문자의 최대 수를 정의 합니다.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. 해당 값이 할당 된 Capacity 속성입니다.Its value is assigned to the Capacity property. 현재 인스턴스에 저장 될 문자 수가이 초과 하는 경우 capacity 값을 StringBuilder 개체를 저장할 추가 메모리를 할당 합니다.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

경우 capacity 이 0 인 구현 별 기본 용량을 사용 합니다.If capacity is zero, the implementation-specific default capacity is used.

maxCapacity 속성은 현재 인스턴스가 보유할 수 있는 문자의 최대 수를 정의 합니다.The maxCapacity property defines the maximum number of characters that the current instance can hold. 해당 값이 할당 된 MaxCapacity 속성입니다.Its value is assigned to the MaxCapacity property. 현재 인스턴스에 저장 될 문자 수가이 초과 하는 경우 maxCapacity 값을 StringBuilder 개체 추가 메모리를 할당 하지 않습니다 하지만 대신 예외가 throw 됩니다.If the number of characters to be stored in the current instance exceeds this maxCapacity value, the StringBuilder object does not allocate additional memory, but instead throws an exception.

호출자 참고

.NET Core 및.NET Framework 4.0 및 이후 버전에서는 인스턴스화할 때 합니다 StringBuilder 호출 하 여 개체를 StringBuilder(Int32, Int32) 생성자, 길이 및 용량을 합니다 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.

추가 정보

StringBuilder(String, Int32) StringBuilder(String, Int32) StringBuilder(String, Int32) StringBuilder(String, Int32)

지정된 문자열과 용량을 사용하여 StringBuilder 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the StringBuilder class using the specified string and capacity.

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 String String String

인스턴스 값을 초기화하는 데 사용되는 문자열입니다.The string used to initialize the value of the instance. valuenull이면 새 StringBuilder에 빈 문자열(Empty)이 포함됩니다.If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

capacity
Int32 Int32 Int32 Int32

StringBuilder의 제안된 시작 크기입니다.The suggested starting size of the StringBuilder.

예외

예제

다음 예제에서는 호출 하는 방법에 설명 합니다 StringBuilder 초기 문자열과 지정 된 용량을 사용 하 여 생성자입니다.The following example demonstrates how to call the StringBuilder constructor with an initial string and a specified capacity.

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);
Dim initialString As String = "Initial string. "
Dim capacity As Integer = 255
Dim stringBuilder As New StringBuilder(initialString, capacity)

설명

capacity 매개 변수는 현재 인스턴스에 의해 할당 된 메모리에 저장할 수 있는 문자의 최대 수를 정의 합니다.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. 해당 값이 할당 된 Capacity 속성입니다.Its value is assigned to the Capacity property. 현재 인스턴스에 저장 될 문자 수가이 초과 하는 경우 capacity 값을 StringBuilder 개체를 저장할 추가 메모리를 할당 합니다.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

경우 capacity 이 0 인 구현 별 기본 용량을 사용 합니다.If capacity is zero, the implementation-specific default capacity is used.

추가 정보

StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32) StringBuilder(String, Int32, Int32, Int32)

지정된 부분 문자열과 용량을 사용하여 StringBuilder 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the StringBuilder class from the specified substring and capacity.

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 String String String

이 인스턴스 값을 초기화하는 데 사용된 부분 문자열이 포함된 문자열입니다.The string that contains the substring used to initialize the value of this instance. valuenull이면 새 StringBuilder에 빈 문자열(Empty)이 포함됩니다.If value is null, the new StringBuilder will contain the empty string (that is, it contains Empty).

startIndex
Int32 Int32 Int32 Int32

value 내에서 부분 문자열이 시작되는 위치입니다.The position within value where the substring begins.

length
Int32 Int32 Int32 Int32

부분 문자열에 있는 문자의 수입니다.The number of characters in the substring.

capacity
Int32 Int32 Int32 Int32

StringBuilder의 제안된 시작 크기입니다.The suggested starting size of the StringBuilder.

예외

capacity가 0보다 작은 경우capacity is less than zero.

또는-or- startIndex+lengthvalue 내의 위치가 아닙니다.startIndex plus length is not a position within value.

예제

다음 예제에서는 호출 하는 방법에 설명 합니다 StringBuilder 지정된 된 문자열을 사용 하 여 생성자입니다.The following example demonstrates how to call the StringBuilder constructor with the specified string.

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);
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 매개 변수는 현재 인스턴스에 의해 할당 된 메모리에 저장할 수 있는 문자의 최대 수를 정의 합니다.The capacity parameter defines the maximum number of characters that can be stored in the memory allocated by the current instance. 해당 값이 할당 된 Capacity 속성입니다.Its value is assigned to the Capacity property. 현재 인스턴스에 저장 될 문자 수가이 초과 하는 경우 capacity 값을 StringBuilder 개체를 저장할 추가 메모리를 할당 합니다.If the number of characters to be stored in the current instance exceeds this capacity value, the StringBuilder object allocates additional memory to store them.

경우 capacity 이 0 인 구현 별 기본 용량을 사용 합니다.If capacity is zero, the implementation-specific default capacity is used.

추가 정보

적용 대상