StringBuilder 생성자

참조

정의

네임스페이스:: System.Text

어셈블리:: System.Runtime.dll

어셈블리:: mscorlib.dll

어셈블리:: netstandard.dll

중요

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

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

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

예외

ArgumentOutOfRangeException

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 구현별 기본 용량이 사용됩니다.

추가 정보

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

인스턴스 값을 초기화하는 데 사용되는 문자열입니다. value가 null이면 새 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)

설명

value가 null이면 새 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

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

예외

ArgumentOutOfRangeException

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

예제

다음 예제에서는 지정된 용량과 최대 용량을 사용하여 생성자를 호출 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)

설명

가 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

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

capacity: Int32

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

예외

ArgumentOutOfRangeException

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)

설명

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

추가 정보

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

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

startIndex: Int32

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

length: Int32

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

capacity: Int32

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

예외

ArgumentOutOfRangeException

capacity가 0보다 작은 경우

또는

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

예제

다음 예제에서는 지정한 문자열을 사용하여 생성자를 호출 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)

설명

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

추가 정보

Capacity

적용 대상

StringBuilder 생성자

정의

오버로드

StringBuilder()

예제

설명

적용 대상

StringBuilder(Int32)

매개 변수

예외

예제

설명

추가 정보

적용 대상

StringBuilder(String)

매개 변수

예제

설명

적용 대상

StringBuilder(Int32, Int32)

매개 변수

예외

예제

설명

호출자 참고

추가 정보

적용 대상

StringBuilder(String, Int32)

매개 변수

예외

예제

설명

추가 정보

적용 대상

StringBuilder(String, Int32, Int32, Int32)

매개 변수

예외

예제

설명

추가 정보

적용 대상

피드백

추가 리소스