TextWriter.WriteLine 메서드 (String, Object, Object, Object)

.NET Framework 4.5

다른 버전

Format 과 같은 의미를 사용하여 서식이 지정된 문자열과 새 줄을 출력합니다.

네임스페이스: System.IO
어셈블리: mscorlib(mscorlib.dll)

구문

C++

public virtual void WriteLine(
	string format,
	Object arg0,
	Object arg1,
	Object arg2
)

매개 변수

format: 형식: System.String
복합 형식 문자열입니다(설명 참조).

arg0: 형식: System.Object
형식을 지정하고 쓰려는 첫 번째 개체입니다.

arg1: 형식: System.Object
형식을 지정하고 쓰려는 두 번째 개체입니다.

arg2: 형식: System.Object
형식을 지정하고 쓰려는 세 번째 개체입니다.

예외

예외	조건
ArgumentNullException	format가 null입니다.
ObjectDisposedException	TextWriter 가 닫힌 경우
IOException	I/O 오류가 발생하는 경우
FormatException	format이 유효한 합성 서식 문자열이 아닙니다. 또는 형식 항목의 인덱스가 0보다 작거나, 형식을 지정할 개체의 수보다 크거나 같은 경우입니다. 즉, 이 메서드 오버로드의 경우는 3입니다.

설명

이 메서드는 .NET Framework의 복합 형식 지정 기능을 사용하여 개체 값을 해당 문자열 표현으로 변환하고 이 표현을 문자열에 포함합니다. .NET Framework에서는 광범위한 형식 지정 기능을 지원합니다. 이러한 지원에 대한 자세한 내용은 다음 형식 지정 항목을 참조하십시오.

합성 형식 지정 기능에 대 한 자세한 내용은 합성 형식 지정.
숫자 형식 지정자에 대한 자세한 내용은 표준 숫자 서식 문자열 및 사용자 지정 숫자 서식 문자열을 참조하십시오.
날짜 및 시간 형식 지정자에 대한 자세한 내용은 표준 날짜 및 시간 서식 문자열 및 사용자 지정 날짜 및 시간 형식 문자열을 참조하십시오.
열거형 형식 지정자에 대한 자세한 내용은 열거형 형식 문자열을 참조하십시오.
형식 지정에 대한 자세한 내용은 형식 서식 지정를 참조하십시오.

format 매개 변수는 이 메서드의 매개 변수 목록에 있는 개체에 해당하는 0개 이상의 인덱싱된 자리 표시자(형식 항목이라고 함)와 결합된 0개 이상의 텍스트로 구성됩니다. 형식 지정 프로세스에서는 각 형식 항목을 해당 개체의 값에 대한 문자열 표현으로 바꿉니다.

형식 항목의 구문은 다음과 같습니다.

{index[,length][:formatString]}

대괄호로 묶인 요소는 선택적입니다. 다음 표에서는 각 요소에 대해 설명합니다. 형식 항목의 구문을 비롯한 합성 형식 지정 기능에 대한 자세한 내용은 합성 형식 지정을 참조하십시오.

요소	설명
인덱스(index)	형식을 지정할 개체의 매개 변수 목록 위치(0부터 시작)입니다. index로 지정된 개체가 null이면 형식 항목이 String.Empty로 대체됩니다. 이 오버 로드의 매개 변수로 개체 세 개 있기 때문에 목록에서 값을 인덱스 항상 0, 1 또는 2 이어야 합니다. index 위치에 매개 변수가 없는 경우 FormatException이 throw됩니다.
,length	매개 변수의 문자열 표현에 포함되는 최소 문자 수입니다. 양수이면 매개 변수가 오른쪽에 맞춰지고, 음수이면 왼쪽에 맞춰집니다.
:formatString	형식을 지정할 개체에서 지원하는 표준 또는 사용자 지정 형식 문자열입니다. formatString의 가능한 값은 해당 개체의 ToString(format) 메서드에서 지원하는 값과 동일합니다. formatString이 지정되어 있지 않고 형식을 지정할 개체가 IFormattable 인터페이스를 구현하는 경우 IFormattable.ToString 형식 문자열로 사용되는 format 매개 변수 값으로 null이 전달됩니다.

앞과 뒤에 사용하는 중괄호 문자 "{" 및 "}"가 필요합니다. format에서 단일 리터럴 중괄호 문자를 지정하려면 "{{" 또는 "}}"와 같이 중괄호 문자를 두 개 지정합니다.

이 이렇게 하지 개별 줄 바꿈 문자 (16 진수 0x000a)에 대 한 지정 된 문자열을 검색 및이 바꿀 NewLine.

형식 문자열에서 지정된 개체를 참조하지 않으면 해당 개체가 무시됩니다.

줄 종결자가 정의 CoreNewLine 필드입니다.

공통적인 I/O 작업 목록은 공통적인 I/O 작업을 참조하십시오.

버전 정보

.NET Framework

4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0에서 지원

.NET Framework Client Profile

4, 3.5 SP1에서 지원

플랫폼

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008(서버 코어 역할은 지원되지 않음), Windows Server 2008 R2(서버 코어 역할은 SP1 이상에서 지원, Itanium은 지원되지 않음)

.NET Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

참고 항목