이 문서는 기계 번역을 이용하여 번역되었습니다. 문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

StringBuilder.Append 메서드 (Char[], Int32, Int32)

 

게시 날짜: 2016년 11월

유니코드 문자의 지정된 하위 배열에 대한 문자열 표현을 이 인스턴스에 추가합니다.

네임스페이스:   System.Text
어셈블리:  mscorlib(mscorlib.dll에 있음)

public StringBuilder Append(
	char[] value,
	int startIndex,
	int charCount
)

매개 변수

value
Type: System.Char[]

문자 배열입니다.

startIndex
Type: System.Int32

value의 시작 위치입니다.

charCount
Type: System.Int32

추가할 문자 수입니다.

반환 값

Type: System.Text.StringBuilder

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

Exception Condition
ArgumentNullException

valuenull이고 startIndexcharCount는 0이 아닙니다.

ArgumentOutOfRangeException

charCount가 0보다 작은 경우

또는

startIndex가 0보다 작은 경우

또는

startIndex + charCountvalue의 길이보다 큽니다.

또는

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

This method appends the specified range of characters in value to the current instance. If value is null and startIndex and count are both zero, no changes are made.

The M:System.Text.StringBuilder.Append(System.Char[],System.Int32,System.Int32) method modifies the existing instance of this class; it does not return a new class instance. Because of this, you can call a method or property on the existing reference and you do not have to assign the return value to a T:System.Text.StringBuilder object, as the following example illustrates.

char[] chars = { 'a', 'b', 'c', 'd', 'e'};
System.Text.StringBuilder sb = new System.Text.StringBuilder();
int startPosition = Array.IndexOf(chars, 'a');
int endPosition = Array.IndexOf(chars, 'c');
if (startPosition >= 0 && endPosition >= 0) {
   sb.Append("The array from positions ").Append(startPosition).
             Append(" to ").Append(endPosition).Append(" contains ").
             Append(chars, startPosition, endPosition + 1).Append(".");
   Console.WriteLine(sb);
}             
// The example displays the following output:
//       The array from positions 0 to 2 contains abc.

The capacity of this instance is adjusted as needed.

호출자 참고 사항:

In thenet_v40_short and the net_v45, when you instantiate the T:System.Text.StringBuilder object by calling the M:System.Text.StringBuilder.#ctor(System.Int32,System.Int32) constructor, both the length and the capacity of the T:System.Text.StringBuilder instance can grow beyond the value of its P:System.Text.StringBuilder.MaxCapacity property. This can occur particularly when you call the M:System.Text.StringBuilder.Append(System.String) and M:System.Text.StringBuilder.AppendFormat(System.String,System.Object) methods to append small strings.

유니버설 Windows 플랫폼
8 이후 사용 가능
.NET Framework
1.1 이후 사용 가능
이식 가능한 클래스 라이브러리
이식 가능한 .NET 플랫폼 에서 지원됨
Silverlight
2.0 이후 사용 가능
Windows Phone Silverlight
7.0 이후 사용 가능
Windows Phone
8.1 이후 사용 가능
맨 위로 이동
표시: