정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

StringBuilder.Append 메서드 (String, Int32, Int32)

2013-12-13

지정된 부분 문자열의 복사본을 이 인스턴스의 끝에 추가합니다.

Namespace:  System.Text
어셈블리:  mscorlib(mscorlib.dll)

public StringBuilder Append(
	string value,
	int startIndex,
	int count
)

매개 변수

value
형식: System.String
추가할 부분 문자열이 들어 있는 String입니다.
startIndex
형식: System.Int32
value에 있는 부분 문자열의 시작 위치입니다.
count
형식: System.Int32
value에서 추가할 문자 수입니다.

반환 값

형식: System.Text.StringBuilder
추가 작업이 완료된 후 이 인스턴스에 대한 참조입니다.

예외조건
ArgumentNullException

valuenull이고 startIndexcount가 0이 아닌 경우.

ArgumentOutOfRangeException

count가 0보다 작은 경우

-또는-

startIndex가 0보다 작은 경우

-또는-

startIndexcount의 합이 value의 길이보다 큰 경우

-또는-

이 인스턴스의 값이 커지면 최대 용량을 초과할 수 있는 경우

이 메서드는 현재 인스턴스에 value의 지정된 문자 범위를 추가합니다. valuenull이고 startIndexcount가 모두 0이면 변경되지 않습니다.

Append 메서드는 이 클래스의 기존 인스턴스를 수정하며, 새 클래스 인스턴스를 반환하지 않습니다. 이로 인해 기존 참조의 메서드 또는 속성을 호출할 수 있으며 다음 예제에서 볼 수 있듯이 StringBuilder 개체에 반환 값을 할당할 필요는 없습니다.


string str = "First;George Washington;1789;1797";
int index = 0;
System.Text.StringBuilder sb = new System.Text.StringBuilder();
int length = str.IndexOf(';', index);      
sb.Append(str, index, length).Append(" President of the United States: ");
index += length + 1;
length = str.IndexOf(';', index) - index;
sb.Append(str, index, length).Append(", from ");
index += length + 1;
length = str.IndexOf(';', index) - index;
sb.Append(str, index, length).Append(" to ");
index += length + 1;
sb.Append(str, index, str.Length - index);
outputBlock.Text += sb + Environment.NewLine;
// The example displays the following output:
//    First President of the United States: George Washington, from 1789 to 1797      


필요에 따라 이 인스턴스의 용량이 조정됩니다.

Windows Phone OS

지원되는 버전: 8.0, 7.1, 7.0

Windows Phone

표시: