TextWriter.WriteLine 메서드

정의

데이터와 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes data to the text stream, followed by a line terminator.

오버로드

WriteLine(String, Object, Object)

Format(String, Object, Object) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열과 새 줄을 텍스트 스트림에 씁니다.Writes a formatted string and a new line to the text stream, using the same semantics as the Format(String, Object, Object) method.

WriteLine(Char[], Int32, Int32)

텍스트 스트림에 줄 종결자가 다음에 오도록 문자의 하위 배열을 씁니다.Writes a subarray of characters to the text stream, followed by a line terminator.

WriteLine(String, Object[])

Format(String, Object)와 동일한 의미 체계를 사용하여 서식이 지정된 문자열과 새 줄을 텍스트 스트림에 씁니다.Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

WriteLine(String, Object)

Format(String, Object) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열과 새 줄을 텍스트 스트림에 씁니다.Writes a formatted string and a new line to the text stream, using the same semantics as the Format(String, Object) method.

WriteLine(UInt64)

부호 없는 8바이트 정수의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes the text representation of an 8-byte unsigned integer to the text stream, followed by a line terminator.

WriteLine(UInt32)

부호 없는 4바이트 정수의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes the text representation of a 4-byte unsigned integer to the text stream, followed by a line terminator.

WriteLine(String, Object, Object, Object)

Format(String, Object)와 동일한 의미 체계를 사용하여 서식이 지정된 문자열과 새 줄을 텍스트 스트림에 씁니다.Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

WriteLine(StringBuilder)

문자열 빌더의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes the text representation of a string builder to the text stream, followed by a line terminator.

WriteLine(String)

문자열과 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes a string to the text stream, followed by a line terminator.

WriteLine(Single)

4바이트 부동 소수점 값의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes the text representation of a 4-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(Double)

8바이트 부동 소수점 값의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes the text representation of a 8-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(Object)

개체에 대해 ToString 메서드를 호출하여 해당 개체의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes the text representation of an object to the text stream, by calling the ToString method on that object, followed by a line terminator.

WriteLine(Int64)

부호 있는 8바이트 정수의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes the text representation of an 8-byte signed integer to the text stream, followed by a line terminator.

WriteLine(Int32)

부호 있는 4바이트 정수의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes the text representation of a 4-byte signed integer to the text stream, followed by a line terminator.

WriteLine(Decimal)

10진수 값의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes the text representation of a decimal value to the text stream, followed by a line terminator.

WriteLine(Char[])

문자의 배열과 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes an array of characters to the text stream, followed by a line terminator.

WriteLine(Char)

텍스트 스트림에 줄 종결자가 다음에 오도록 문자를 씁니다.Writes a character to the text stream, followed by a line terminator.

WriteLine(Boolean)

텍스트 스트림에 줄 종결자가 다음에 오도록 Boolean 값의 텍스트 표현을 씁니다.Writes the text representation of a Boolean value to the text stream, followed by a line terminator.

WriteLine()

줄 종결자를 텍스트 스트림에 씁니다.Writes a line terminator to the text stream.

WriteLine(ReadOnlySpan<Char>)

텍스트 스트림에 줄 종결자가 다음에 오도록 문자 범위의 텍스트 표현을 씁니다.Writes the text representation of a character span to the text stream, followed by a line terminator.

WriteLine(String, Object, Object)

Format(String, Object, Object) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열과 새 줄을 텍스트 스트림에 씁니다.Writes a formatted string and a new line to the text stream, using the same semantics as the Format(String, Object, Object) method.

public:
 virtual void WriteLine(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public virtual void WriteLine (string format, object arg0, object arg1);
public virtual void WriteLine (string format, object? arg0, object? arg1);
abstract member WriteLine : string * obj * obj -> unit
override this.WriteLine : string * obj * obj -> unit
Public Overridable Sub WriteLine (format As String, arg0 As Object, arg1 As Object)

매개 변수

format
String

복합 형식 문자열입니다.A composite format string.

arg0
Object

서식을 지정하고 쓸 첫 번째 개체입니다.The first object to format and write.

arg1
Object

서식을 지정하고 쓸 두 번째 개체입니다.The second object to format and write.

예외

format이(가) null인 경우format is null.

TextWriter가 닫혔습니다.The TextWriter is closed.

I/O 오류가 발생했습니다.An I/O error occurs.

format이 유효한 합성 서식 문자열이 아닙니다.format is not a valid composite format string.

또는-or- 서식 항목의 인덱스가 0보다 작거나, 형식을 지정할 개체의 수보다 크거나 같은 경우입니다. 즉, 이 메서드 오버로드의 경우는 2입니다.The index of a format item is less than 0 (zero), or greater than or equal to the number of objects to be formatted (which, for this method overload, is two).

설명

이 메서드는 복합 서식 지정을 사용 하 여 개체의 값을 문자열 표현으로 변환 하 고 문자열에 해당 표현을 포함 합니다.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. .NET에서는 다음과 같은 서식 지정 항목에 자세히 설명 되어 있는 광범위 한 서식 지정 지원을 제공 합니다..NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

format매개 변수는이 메서드의 매개 변수 목록에 있는 개체에 해당 하는 0 개 이상의 인덱싱된 자리 표시자 (서식 항목 이라고 함)와 결합 된 0 개 이상의 텍스트 실행으로 구성 됩니다.The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. 서식 지정 프로세스에서는 각 형식 항목을 해당 개체의 값에 대 한 문자열 표현으로 바꿉니다.The formatting process replaces each format item with the string representation of the value of the corresponding object.

서식 항목의 구문은 다음과 같습니다.The syntax of a format item is as follows:

{index[,length] [:formatString]}{index[,length][:formatString]}

대괄호 안의 요소는 선택 사항입니다.Elements in square brackets are optional. 다음 표에서는 각 요소에 대해 설명합니다.The following table describes each element. 서식 항목의 구문을 비롯 한 복합 서식 지정 기능에 대 한 자세한 내용은 복합 형식 지정을 참조 하세요.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

요소Element DescriptionDescription
인덱스index 형식을 지정할 개체의 매개 변수 목록에서 0부터 시작 하는 위치입니다.The zero-based position in the parameter list of the object to be formatted. Index 로 지정 된 개체가 이면 null 형식 항목이로 바뀝니다 String.Empty .If the object specified by index is null, the format item is replaced by String.Empty. 이 오버 로드는 매개 변수 목록에 두 개의 개체를 포함 하므로 인덱스 값은 항상 0 또는 1 이어야 합니다.Because this overload has two objects in its parameter list, the value of index must always be 0 or 1. 인덱스 위치에 매개 변수가 없으면 FormatException 이 throw 됩니다.If there is no parameter in the index position, a FormatException is thrown.
,길이,length 매개 변수의 문자열 표현에 있는 최소 문자 수입니다.The minimum number of characters in the string representation of the parameter. 양수 이면 매개 변수가 오른쪽에 맞춰집니다. 음수 이면 왼쪽에 맞춰집니다.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:formatString:formatString 형식을 지정할 개체에서 지 원하는 표준 또는 사용자 지정 서식 문자열입니다.A standard or custom format string that is supported by the object to be formatted. FormatString 에 사용할 수 있는 값은 개체의 메서드에서 지원 되는 값과 같습니다 ToString(string format) .Possible values for formatString are the same as the values supported by the object's ToString(string format) method. FormatString 을 지정 하지 않고 형식을 지정할 개체가 인터페이스를 구현 하는 경우 IFormattable nullformat IFormattable.ToString 형식 문자열로 사용 되는 매개 변수의 값으로 전달 됩니다.If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

선행 및 후행 중괄호 문자 "{" 및 "}"가 필요 합니다.The leading and trailing brace characters, "{" and "}", are required. 에서 단일 리터럴 중괄호 문자를 지정 하려면 format 두 개의 선행 또는 후행 중괄호 문자 (즉, "{{" 또는 "}}")를 지정 합니다.To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

이 메서드는 지정 된 문자열에서 개별 줄 바꿈 문자 (16 진수 0x000a)를 검색 하지 않고로 바꿉니다 NewLine .This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

지정 된 개체가 형식 문자열에서 참조 되지 않는 경우에는 무시 됩니다.If a specified object is not referenced in the format string, it is ignored.

줄 종결자는 필드에 의해 정의 됩니다 CoreNewLine .The line terminator is defined by the CoreNewLine field.

일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

추가 정보

적용 대상

WriteLine(Char[], Int32, Int32)

텍스트 스트림에 줄 종결자가 다음에 오도록 문자의 하위 배열을 씁니다.Writes a subarray of characters to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(cli::array <char> ^ buffer, int index, int count);
public virtual void WriteLine (char[] buffer, int index, int count);
abstract member WriteLine : char[] * int * int -> unit
override this.WriteLine : char[] * int * int -> unit
Public Overridable Sub WriteLine (buffer As Char(), index As Integer, count As Integer)

매개 변수

buffer
Char[]

데이터를 읽을 문자 배열입니다.The character array from which data is read.

index
Int32

데이터 읽기를 시작하는 buffer의 문자 위치입니다.The character position in buffer at which to start reading data.

count
Int32

쓸 최대 문자 수입니다.The maximum number of characters to write.

예외

버퍼 길이에서 index를 빼면 count보다 작습니다.The buffer length minus index is less than count.

buffer 매개 변수가 null인 경우The buffer parameter is null.

index 또는 count가 음수입니다.index or count is negative.

TextWriter가 닫혔습니다.The TextWriter is closed.

I/O 오류가 발생했습니다.An I/O error occurs.

설명

이 메서드는 count TextWriter 위치에서 시작 하는 문자 배열에서 데이터의 문자를이에 씁니다 buffer index .This method will write count characters of data into this TextWriter from the buffer character array starting at position index.

이 오버 로드는 Write(Char[]) 메서드와 WriteLine buffer () 사이의 각 문자에 대해 메서드를 index index + 호출 하는 것 count 과 같습니다.This overload is equivalent to calling the Write(Char[]) method followed by WriteLine for each character in buffer between index and (index + count).

줄 종결자는 필드에 의해 정의 됩니다 CoreNewLine .The line terminator is defined by the CoreNewLine field.

일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

추가 정보

적용 대상

WriteLine(String, Object[])

Format(String, Object)와 동일한 의미 체계를 사용하여 서식이 지정된 문자열과 새 줄을 텍스트 스트림에 씁니다.Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

public:
 virtual void WriteLine(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public virtual void WriteLine (string format, params object[] arg);
public virtual void WriteLine (string format, params object?[] arg);
abstract member WriteLine : string * obj[] -> unit
override this.WriteLine : string * obj[] -> unit
Public Overridable Sub WriteLine (format As String, ParamArray arg As Object())

매개 변수

format
String

복합 형식 문자열입니다.A composite format string.

arg
Object[]

서식을 지정하고 쓸 개체를 0개 이상 포함하는 개체 배열입니다.An object array that contains zero or more objects to format and write.

예외

문자열이나 개체가 null로 전달되는 경우A string or object is passed in as null.

TextWriter가 닫혔습니다.The TextWriter is closed.

I/O 오류가 발생했습니다.An I/O error occurs.

format이 유효한 합성 서식 문자열이 아닙니다.format is not a valid composite format string.

또는-or- 형식 항목의 인덱스가 0보다 작거나 arg 배열의 길이보다 크거나 같습니다.The index of a format item is less than 0 (zero), or greater than or equal to the length of the arg array.

설명

이 메서드는 복합 서식 지정을 사용 하 여 개체의 값을 문자열 표현으로 변환 하 고 문자열에 해당 표현을 포함 합니다.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. .NET에서는 다음과 같은 서식 지정 항목에 자세히 설명 되어 있는 광범위 한 서식 지정 지원을 제공 합니다..NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

format매개 변수는이 메서드의 매개 변수 목록에 있는 개체에 해당 하는 0 개 이상의 인덱싱된 자리 표시자 (서식 항목 이라고 함)와 결합 된 0 개 이상의 텍스트 실행으로 구성 됩니다.The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. 서식 지정 프로세스에서는 각 형식 항목을 해당 개체의 값에 대 한 문자열 표현으로 바꿉니다.The formatting process replaces each format item with the string representation of the value of the corresponding object.

서식 항목의 구문은 다음과 같습니다.The syntax of a format item is as follows:

{index[,length] [:formatString]}{index[,length][:formatString]}

대괄호 안의 요소는 선택 사항입니다.Elements in square brackets are optional. 다음 표에서는 각 요소에 대해 설명합니다.The following table describes each element. 서식 항목의 구문을 비롯 한 복합 서식 지정 기능에 대 한 자세한 내용은 복합 형식 지정을 참조 하세요.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

요소Element DescriptionDescription
인덱스index 형식을 지정할 개체의 매개 변수 목록에서 0부터 시작 하는 위치입니다.The zero-based position in the parameter list of the object to be formatted. Index 로 지정 된 개체가 이면 null 형식 항목이로 바뀝니다 String.Empty .If the object specified by index is null, the format item is replaced by String.Empty. 이 오버 로드는 매개 변수 목록에 배열이 있으므로 인덱스 값은 항상 배열 길이 보다 작아야 합니다.Because this overload has an array in its parameter list, the value of index must always be less than the length of the array. 인덱스 위치에 매개 변수가 없으면 FormatException 이 throw 됩니다.If there is no parameter in the index position, a FormatException is thrown.
,길이,length 매개 변수의 문자열 표현에 있는 최소 문자 수입니다.The minimum number of characters in the string representation of the parameter. 양수 이면 매개 변수가 오른쪽에 맞춰집니다. 음수 이면 왼쪽에 맞춰집니다.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:formatString:formatString 형식을 지정할 개체에서 지 원하는 표준 또는 사용자 지정 서식 문자열입니다.A standard or custom format string that is supported by the object to be formatted. FormatString 에 사용할 수 있는 값은 개체의 메서드에서 지원 되는 값과 같습니다 ToString(string format) .Possible values for formatString are the same as the values supported by the object's ToString(string format) method. FormatString 을 지정 하지 않고 형식을 지정할 개체가 인터페이스를 구현 하는 경우 IFormattable nullformat IFormattable.ToString 형식 문자열로 사용 되는 매개 변수의 값으로 전달 됩니다.If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

선행 및 후행 중괄호 문자 "{" 및 "}"가 필요 합니다.The leading and trailing brace characters, "{" and "}", are required. 에서 단일 리터럴 중괄호 문자를 지정 하려면 format 두 개의 선행 또는 후행 중괄호 문자 (즉, "{{" 또는 "}}")를 지정 합니다.To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

이 메서드는 지정 된 문자열에서 개별 줄 바꿈 문자 (16 진수 0x000a)를 검색 하지 않고로 바꿉니다 NewLine .This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

지정 된 개체가 형식 문자열에서 참조 되지 않는 경우에는 무시 됩니다.If a specified object is not referenced in the format string, it is ignored.

줄 종결자는 필드에 의해 정의 됩니다 CoreNewLine .The line terminator is defined by the CoreNewLine field.

일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

추가 정보

적용 대상

WriteLine(String, Object)

Format(String, Object) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열과 새 줄을 텍스트 스트림에 씁니다.Writes a formatted string and a new line to the text stream, using the same semantics as the Format(String, Object) method.

public:
 virtual void WriteLine(System::String ^ format, System::Object ^ arg0);
public virtual void WriteLine (string format, object arg0);
public virtual void WriteLine (string format, object? arg0);
abstract member WriteLine : string * obj -> unit
override this.WriteLine : string * obj -> unit
Public Overridable Sub WriteLine (format As String, arg0 As Object)

매개 변수

format
String

복합 형식 문자열입니다.A composite format string.

arg0
Object

서식을 지정하고 쓸 개체입니다.The object to format and write.

예외

format이(가) null인 경우format is null.

TextWriter가 닫혔습니다.The TextWriter is closed.

I/O 오류가 발생했습니다.An I/O error occurs.

format이 유효한 합성 서식 문자열이 아닙니다.format is not a valid composite format string.

또는-or- 형식 항목의 인덱스가 0보다 작거나, 형식을 지정할 개체의 수보다 크거나 같은 경우입니다. 즉, 이 메서드 오버로드의 경우는 1입니다.The index of a format item is less than 0 (zero), or greater than or equal to the number of objects to be formatted (which, for this method overload, is one).

설명

이 메서드는 복합 서식 지정을 사용 하 여 개체의 값을 문자열 표현으로 변환 하 고 문자열에 해당 표현을 포함 합니다.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. .NET에서는 다음과 같은 서식 지정 항목에 자세히 설명 되어 있는 광범위 한 서식 지정 지원을 제공 합니다..NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

format매개 변수는이 메서드의 매개 변수 목록에 있는 개체에 해당 하는 0 개 이상의 인덱싱된 자리 표시자 (서식 항목 이라고 함)와 결합 된 0 개 이상의 텍스트 실행으로 구성 됩니다.The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. 서식 지정 프로세스에서는 각 형식 항목을 해당 개체의 값에 대 한 문자열 표현으로 바꿉니다.The formatting process replaces each format item with the string representation of the value of the corresponding object.

서식 항목의 구문은 다음과 같습니다.The syntax of a format item is as follows:

{index[,length] [:formatString]}{index[,length][:formatString]}

대괄호 안의 요소는 선택 사항입니다.Elements in square brackets are optional. 다음 표에서는 각 요소에 대해 설명합니다.The following table describes each element. 서식 항목의 구문을 비롯 한 복합 서식 지정 기능에 대 한 자세한 내용은 복합 형식 지정을 참조 하세요.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

요소Element DescriptionDescription
인덱스index 형식을 지정할 개체의 매개 변수 목록에서 0부터 시작 하는 위치입니다.The zero-based position in the parameter list of the object to be formatted. Index 로 지정 된 개체가 이면 null 형식 항목이로 바뀝니다 String.Empty .If the object specified by index is null, the format item is replaced by String.Empty. 이 오버 로드는 매개 변수 목록에 단일 개체만 있으므로 인덱스 값은 항상 0 이어야 합니다.Because this overload has only a single object in its parameter list, the value of index must always be 0. 인덱스 위치에 매개 변수가 없으면 FormatException 이 throw 됩니다.If there is no parameter in the index position, a FormatException is thrown.
,길이,length 매개 변수의 문자열 표현에 있는 최소 문자 수입니다.The minimum number of characters in the string representation of the parameter. 양수 이면 매개 변수가 오른쪽에 맞춰집니다. 음수 이면 왼쪽에 맞춰집니다.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:formatString:formatString 형식을 지정할 개체에서 지 원하는 표준 또는 사용자 지정 서식 문자열입니다.A standard or custom format string that is supported by the object to be formatted. FormatString 에 사용할 수 있는 값은 개체의 메서드에서 지원 되는 값과 같습니다 ToString(string format) .Possible values for formatString are the same as the values supported by the object's ToString(string format) method. FormatString 을 지정 하지 않고 형식을 지정할 개체가 인터페이스를 구현 하는 경우 IFormattable nullformat IFormattable.ToString 형식 문자열로 사용 되는 매개 변수의 값으로 전달 됩니다.If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

선행 및 후행 중괄호 문자 "{" 및 "}"가 필요 합니다.The leading and trailing brace characters, "{" and "}", are required. 에서 단일 리터럴 중괄호 문자를 지정 하려면 format 두 개의 선행 또는 후행 중괄호 문자 (즉, "{{" 또는 "}}")를 지정 합니다.To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

이 메서드는 지정 된 문자열에서 개별 줄 바꿈 문자 (16 진수 0x000a)를 검색 하지 않고로 바꿉니다 NewLine .This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

지정 된 개체가 형식 문자열에서 참조 되지 않는 경우에는 무시 됩니다.If a specified object is not referenced in the format string, it is ignored.

줄 종결자는 필드에 의해 정의 됩니다 CoreNewLine .The line terminator is defined by the CoreNewLine field.

일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

추가 정보

적용 대상

WriteLine(UInt64)

중요

이 API는 CLS 규격이 아닙니다.

부호 없는 8바이트 정수의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes the text representation of an 8-byte unsigned integer to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(System::UInt64 value);
[System.CLSCompliant(false)]
public virtual void WriteLine (ulong value);
[<System.CLSCompliant(false)>]
abstract member WriteLine : uint64 -> unit
override this.WriteLine : uint64 -> unit
Public Overridable Sub WriteLine (value As ULong)

매개 변수

value
UInt64

쓸 부호 없는 8바이트 정수입니다.The 8-byte unsigned integer to write.

특성

예외

TextWriter가 닫혔습니다.The TextWriter is closed.

I/O 오류가 발생했습니다.An I/O error occurs.

설명

지정 된 값의 텍스트 표현은 메서드를 호출 하 여 생성 됩니다 UInt64.ToString .The text representation of the specified value is produced by calling the UInt64.ToString method. FormatProvider속성이가 아닌 경우 속성은 null 문화권별 형식을 지정 합니다.The FormatProvider property, if not null, specifies the culture-specific formatting.

줄 종결자는 필드에 의해 정의 됩니다 CoreNewLine .The line terminator is defined by the CoreNewLine field.

일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

추가 정보

적용 대상

WriteLine(UInt32)

중요

이 API는 CLS 규격이 아닙니다.

부호 없는 4바이트 정수의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes the text representation of a 4-byte unsigned integer to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(System::UInt32 value);
[System.CLSCompliant(false)]
public virtual void WriteLine (uint value);
[<System.CLSCompliant(false)>]
abstract member WriteLine : uint32 -> unit
override this.WriteLine : uint32 -> unit
Public Overridable Sub WriteLine (value As UInteger)

매개 변수

value
UInt32

쓸 부호 없는 4바이트 정수입니다.The 4-byte unsigned integer to write.

특성

예외

TextWriter가 닫혔습니다.The TextWriter is closed.

I/O 오류가 발생했습니다.An I/O error occurs.

설명

지정 된 값의 텍스트 표현은 메서드를 호출 하 여 생성 됩니다 UInt32.ToString .The text representation of the specified value is produced by calling the UInt32.ToString method. FormatProvider속성이가 아닌 경우 속성은 null 문화권별 형식을 지정 합니다.The FormatProvider property, if not null, specifies the culture-specific formatting.

줄 종결자는 필드에 의해 정의 됩니다 CoreNewLine .The line terminator is defined by the CoreNewLine field.

일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

추가 정보

적용 대상

WriteLine(String, Object, Object, Object)

Format(String, Object)와 동일한 의미 체계를 사용하여 서식이 지정된 문자열과 새 줄을 텍스트 스트림에 씁니다.Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

public:
 virtual void WriteLine(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);
public virtual void WriteLine (string format, object arg0, object arg1, object arg2);
public virtual void WriteLine (string format, object? arg0, object? arg1, object? arg2);
abstract member WriteLine : string * obj * obj * obj -> unit
override this.WriteLine : string * obj * obj * obj -> unit
Public Overridable Sub WriteLine (format As String, arg0 As Object, arg1 As Object, arg2 As Object)

매개 변수

format
String

복합 형식 문자열입니다.A composite format string.

arg0
Object

서식을 지정하고 쓸 첫 번째 개체입니다.The first object to format and write.

arg1
Object

서식을 지정하고 쓸 두 번째 개체입니다.The second object to format and write.

arg2
Object

서식을 지정하고 쓸 세 번째 개체입니다.The third object to format and write.

예외

format이(가) null인 경우format is null.

TextWriter가 닫혔습니다.The TextWriter is closed.

I/O 오류가 발생했습니다.An I/O error occurs.

format이 유효한 합성 서식 문자열이 아닙니다.format is not a valid composite format string.

또는-or- 형식 항목의 인덱스가 0보다 작거나, 형식을 지정할 개체의 수보다 크거나 같은 경우입니다. 즉, 이 메서드 오버로드의 경우는 3입니다.The index of a format item is less than 0 (zero), or greater than or equal to the number of objects to be formatted (which, for this method overload, is three).

설명

이 메서드는 복합 서식 지정을 사용 하 여 개체의 값을 문자열 표현으로 변환 하 고 문자열에 해당 표현을 포함 합니다.This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. .NET에서는 다음과 같은 서식 지정 항목에 자세히 설명 되어 있는 광범위 한 서식 지정 지원을 제공 합니다..NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

format매개 변수는이 메서드의 매개 변수 목록에 있는 개체에 해당 하는 0 개 이상의 인덱싱된 자리 표시자 (서식 항목 이라고 함)와 결합 된 0 개 이상의 텍스트 실행으로 구성 됩니다.The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. 서식 지정 프로세스에서는 각 형식 항목을 해당 개체의 값에 대 한 문자열 표현으로 바꿉니다.The formatting process replaces each format item with the string representation of the value of the corresponding object.

서식 항목의 구문은 다음과 같습니다.The syntax of a format item is as follows:

{index[,length] [:formatString]}{index[,length][:formatString]}

대괄호 안의 요소는 선택 사항입니다.Elements in square brackets are optional. 다음 표에서는 각 요소에 대해 설명합니다.The following table describes each element. 서식 항목의 구문을 비롯 한 복합 서식 지정 기능에 대 한 자세한 내용은 복합 형식 지정을 참조 하세요.For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

요소Element DescriptionDescription
인덱스index 형식을 지정할 개체의 매개 변수 목록에서 0부터 시작 하는 위치입니다.The zero-based position in the parameter list of the object to be formatted. Index 로 지정 된 개체가 이면 null 형식 항목이로 바뀝니다 String.Empty .If the object specified by index is null, the format item is replaced by String.Empty. 이 오버 로드의 매개 변수 목록에는 세 개의 개체가 있으므로 인덱스 값은 항상 0, 1 또는 2 여야 합니다.Because this overload has three objects in its parameter list, the value of index must always be 0, 1, or 2. 인덱스 위치에 매개 변수가 없으면 FormatException 이 throw 됩니다.If there is no parameter in the index position, a FormatException is thrown.
,길이,length 매개 변수의 문자열 표현에 있는 최소 문자 수입니다.The minimum number of characters in the string representation of the parameter. 양수 이면 매개 변수가 오른쪽에 맞춰집니다. 음수 이면 왼쪽에 맞춰집니다.If positive, the parameter is right-aligned; if negative, it is left-aligned.
:formatString:formatString 형식을 지정할 개체에서 지 원하는 표준 또는 사용자 지정 서식 문자열입니다.A standard or custom format string that is supported by the object to be formatted. FormatString 에 사용할 수 있는 값은 개체의 메서드에서 지원 되는 값과 같습니다 ToString(string format) .Possible values for formatString are the same as the values supported by the object's ToString(string format) method. FormatString 을 지정 하지 않고 형식을 지정할 개체가 인터페이스를 구현 하는 경우 IFormattable nullformat IFormattable.ToString 형식 문자열로 사용 되는 매개 변수의 값으로 전달 됩니다.If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

선행 및 후행 중괄호 문자 "{" 및 "}"가 필요 합니다.The leading and trailing brace characters, "{" and "}", are required. 에서 단일 리터럴 중괄호 문자를 지정 하려면 format 두 개의 선행 또는 후행 중괄호 문자 (즉, "{{" 또는 "}}")를 지정 합니다.To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

이 메서드는 지정 된 문자열에서 개별 줄 바꿈 문자 (16 진수 0x000a)를 검색 하지 않고로 바꿉니다 NewLine .This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

지정 된 개체가 형식 문자열에서 참조 되지 않는 경우에는 무시 됩니다.If a specified object is not referenced in the format string, it is ignored.

줄 종결자는 필드에 의해 정의 됩니다 CoreNewLine .The line terminator is defined by the CoreNewLine field.

일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

추가 정보

적용 대상

WriteLine(StringBuilder)

문자열 빌더의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes the text representation of a string builder to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(System::Text::StringBuilder ^ value);
public virtual void WriteLine (System.Text.StringBuilder? value);
abstract member WriteLine : System.Text.StringBuilder -> unit
override this.WriteLine : System.Text.StringBuilder -> unit
Public Overridable Sub WriteLine (value As StringBuilder)

매개 변수

value
StringBuilder

텍스트 스트림에 문자열 작성기로 쓸 문자열입니다.The string, as a string builder, to write to the text stream.

설명

지정 된 값의 텍스트 표현은 메서드를 호출 하 여 생성 됩니다 StringBuilder.ToString .The text representation of the specified value is produced by calling the StringBuilder.ToString method.

줄 종결자는 필드에 의해 정의 됩니다 CoreNewLine .The line terminator is defined by the CoreNewLine field.

일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

적용 대상

WriteLine(String)

문자열과 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes a string to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(System::String ^ value);
public virtual void WriteLine (string value);
public virtual void WriteLine (string? value);
abstract member WriteLine : string -> unit
override this.WriteLine : string -> unit
Public Overridable Sub WriteLine (value As String)

매개 변수

value
String

쓸 문자열입니다.The string to write. valuenull이면 줄 종결자만 씁니다.If value is null, only the line terminator is written.

예외

TextWriter가 닫혔습니다.The TextWriter is closed.

I/O 오류가 발생했습니다.An I/O error occurs.

설명

이 오버 로드는 Write(Char[]) 오버 로드와 동일 합니다.This overload is equivalent to the Write(Char[]) overload.

줄 종결자는 필드에 의해 정의 됩니다 CoreNewLine .The line terminator is defined by the CoreNewLine field.

이 메서드는 지정 된 문자열에서 개별 줄 바꿈 문자 (16 진수 0x000a)를 검색 하지 않고로 바꿉니다 NewLine .This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

추가 정보

적용 대상

WriteLine(Single)

4바이트 부동 소수점 값의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes the text representation of a 4-byte floating-point value to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(float value);
public virtual void WriteLine (float value);
abstract member WriteLine : single -> unit
override this.WriteLine : single -> unit
Public Overridable Sub WriteLine (value As Single)

매개 변수

value
Single

쓸 4바이트 부동 소수점 값입니다.The 4-byte floating-point value to write.

예외

TextWriter가 닫혔습니다.The TextWriter is closed.

I/O 오류가 발생했습니다.An I/O error occurs.

설명

FormatProvider속성이가 아닌 경우 속성은 null 문화권별 형식을 지정 합니다.The FormatProvider property, if not null, specifies the culture-specific formatting. 일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

줄 종결자는 필드에 의해 정의 됩니다 CoreNewLine .The line terminator is defined by the CoreNewLine field.

추가 정보

적용 대상

WriteLine(Double)

8바이트 부동 소수점 값의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes the text representation of a 8-byte floating-point value to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(double value);
public virtual void WriteLine (double value);
abstract member WriteLine : double -> unit
override this.WriteLine : double -> unit
Public Overridable Sub WriteLine (value As Double)

매개 변수

value
Double

쓸 8바이트 부동 소수점 값입니다.The 8-byte floating-point value to write.

예외

TextWriter가 닫혔습니다.The TextWriter is closed.

I/O 오류가 발생했습니다.An I/O error occurs.

설명

FormatProvider속성이가 아닌 경우 속성은 null 문화권별 형식을 지정 합니다.The FormatProvider property, if not null, specifies the culture-specific formatting. 일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

줄 종결자는 필드에 의해 정의 됩니다 CoreNewLine .The line terminator is defined by the CoreNewLine field.

추가 정보

적용 대상

WriteLine(Object)

개체에 대해 ToString 메서드를 호출하여 해당 개체의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes the text representation of an object to the text stream, by calling the ToString method on that object, followed by a line terminator.

public:
 virtual void WriteLine(System::Object ^ value);
public virtual void WriteLine (object value);
public virtual void WriteLine (object? value);
abstract member WriteLine : obj -> unit
override this.WriteLine : obj -> unit
Public Overridable Sub WriteLine (value As Object)

매개 변수

value
Object

쓸 개체입니다.The object to write. valuenull이면 줄 종결자만 씁니다.If value is null, only the line terminator is written.

예외

TextWriter가 닫혔습니다.The TextWriter is closed.

I/O 오류가 발생했습니다.An I/O error occurs.

설명

이 오버 로드는 Write(String, Object) 오버 로드와 동일 합니다.This overload is equivalent to the Write(String, Object) overload. FormatProvider속성이가 아닌 경우 속성은 null 문화권별 형식을 지정 합니다.The FormatProvider property, if not null, specifies the culture-specific formatting.

줄 종결자는 필드에 의해 정의 됩니다 CoreNewLine .The line terminator is defined by the CoreNewLine field.

일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

추가 정보

적용 대상

WriteLine(Int64)

부호 있는 8바이트 정수의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes the text representation of an 8-byte signed integer to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(long value);
public virtual void WriteLine (long value);
abstract member WriteLine : int64 -> unit
override this.WriteLine : int64 -> unit
Public Overridable Sub WriteLine (value As Long)

매개 변수

value
Int64

쓸 부호 있는 8바이트 정수입니다.The 8-byte signed integer to write.

예외

TextWriter가 닫혔습니다.The TextWriter is closed.

I/O 오류가 발생했습니다.An I/O error occurs.

설명

지정 된 값의 텍스트 표현은 메서드를 호출 하 여 생성 됩니다 Int64.ToString .The text representation of the specified value is produced by calling the Int64.ToString method. TextWriter.FormatProvider속성이가 아닌 경우 속성은 null 문화권별 형식을 지정 합니다.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

줄 종결자는 필드에 의해 정의 됩니다 CoreNewLine .The line terminator is defined by the CoreNewLine field.

일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

추가 정보

적용 대상

WriteLine(Int32)

부호 있는 4바이트 정수의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes the text representation of a 4-byte signed integer to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(int value);
public virtual void WriteLine (int value);
abstract member WriteLine : int -> unit
override this.WriteLine : int -> unit
Public Overridable Sub WriteLine (value As Integer)

매개 변수

value
Int32

쓸 부호 있는 4바이트 정수입니다.The 4-byte signed integer to write.

예외

TextWriter가 닫혔습니다.The TextWriter is closed.

I/O 오류가 발생했습니다.An I/O error occurs.

설명

지정 된 값의 텍스트 표현은 메서드를 호출 하 여 생성 됩니다 Int32.ToString .The text representation of the specified value is produced by calling the Int32.ToString method. TextWriter.FormatProvider속성이가 아닌 경우 속성은 null 문화권별 형식을 지정 합니다.The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

줄 종결자는 필드에 의해 정의 됩니다 CoreNewLine .The line terminator is defined by the CoreNewLine field.

일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

추가 정보

적용 대상

WriteLine(Decimal)

10진수 값의 텍스트 표현과 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes the text representation of a decimal value to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(System::Decimal value);
public virtual void WriteLine (decimal value);
abstract member WriteLine : decimal -> unit
override this.WriteLine : decimal -> unit
Public Overridable Sub WriteLine (value As Decimal)

매개 변수

value
Decimal

쓸 10진수 값입니다.The decimal value to write.

예외

TextWriter가 닫혔습니다.The TextWriter is closed.

I/O 오류가 발생했습니다.An I/O error occurs.

설명

FormatProvider속성이가 아닌 경우 속성은 null 문화권별 형식을 지정 합니다.The FormatProvider property, if not null, specifies the culture-specific formatting. 일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

줄 종결자는 필드에 의해 정의 됩니다 CoreNewLine .The line terminator is defined by the CoreNewLine field.

추가 정보

적용 대상

WriteLine(Char[])

문자의 배열과 줄 종결자를 차례로 텍스트 스트림에 씁니다.Writes an array of characters to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(cli::array <char> ^ buffer);
public virtual void WriteLine (char[] buffer);
public virtual void WriteLine (char[]? buffer);
abstract member WriteLine : char[] -> unit
override this.WriteLine : char[] -> unit
Public Overridable Sub WriteLine (buffer As Char())

매개 변수

buffer
Char[]

데이터를 읽을 문자 배열입니다.The character array from which data is read.

예외

TextWriter가 닫혔습니다.The TextWriter is closed.

I/O 오류가 발생했습니다.An I/O error occurs.

설명

의 모든 문자는 buffer 내부 스트림에 쓰여집니다.All the characters in buffer are written to the underlying stream. 문자 배열이 null이면 줄 종결자만 씁니다.If the character array is null, only the line terminator is written.

이 오버 로드는 다음에와 동일 Write(Char[]) WriteLine() 합니다.This overload is equivalent to Write(Char[]) followed by WriteLine() .

줄 종결자는 필드에 의해 정의 됩니다 CoreNewLine .The line terminator is defined by the CoreNewLine field.

일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

추가 정보

적용 대상

WriteLine(Char)

텍스트 스트림에 줄 종결자가 다음에 오도록 문자를 씁니다.Writes a character to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(char value);
public virtual void WriteLine (char value);
abstract member WriteLine : char -> unit
override this.WriteLine : char -> unit
Public Overridable Sub WriteLine (value As Char)

매개 변수

value
Char

텍스트 스트림에 쓸 문자입니다.The character to write to the text stream.

예외

TextWriter가 닫혔습니다.The TextWriter is closed.

I/O 오류가 발생했습니다.An I/O error occurs.

설명

이 오버 로드는 다음에와 동일 Write(Char) WriteLine() 합니다.This overload is equivalent to Write(Char) followed by WriteLine() .

줄 종결자는 필드에 의해 정의 됩니다 CoreNewLine .The line terminator is defined by the CoreNewLine field.

일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

추가 정보

적용 대상

WriteLine(Boolean)

텍스트 스트림에 줄 종결자가 다음에 오도록 Boolean 값의 텍스트 표현을 씁니다.Writes the text representation of a Boolean value to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(bool value);
public virtual void WriteLine (bool value);
abstract member WriteLine : bool -> unit
override this.WriteLine : bool -> unit
Public Overridable Sub WriteLine (value As Boolean)

매개 변수

value
Boolean

Boolean 값입니다.The Boolean value to write.

예외

TextWriter가 닫혔습니다.The TextWriter is closed.

I/O 오류가 발생했습니다.An I/O error occurs.

설명

지정 된 값의 텍스트 표현은 메서드를 호출 하 여 생성 됩니다 Boolean.ToString .The text representation of the specified value is produced by calling the Boolean.ToString method.

이 메서드는 Boolean.TrueString 또는 Boolean.FalseString 를 출력 합니다.This method outputs either Boolean.TrueString or Boolean.FalseString.

줄 종결자는 필드에 의해 정의 됩니다 CoreNewLine .The line terminator is defined by the CoreNewLine field.

일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

추가 정보

적용 대상

WriteLine()

줄 종결자를 텍스트 스트림에 씁니다.Writes a line terminator to the text stream.

public:
 virtual void WriteLine();
public virtual void WriteLine ();
abstract member WriteLine : unit -> unit
override this.WriteLine : unit -> unit
Public Overridable Sub WriteLine ()

예외

TextWriter가 닫혔습니다.The TextWriter is closed.

I/O 오류가 발생했습니다.An I/O error occurs.

설명

줄 종결자는 필드에 의해 정의 됩니다 CoreNewLine .The line terminator is defined by the CoreNewLine field.

일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

추가 정보

적용 대상

WriteLine(ReadOnlySpan<Char>)

텍스트 스트림에 줄 종결자가 다음에 오도록 문자 범위의 텍스트 표현을 씁니다.Writes the text representation of a character span to the text stream, followed by a line terminator.

public:
 virtual void WriteLine(ReadOnlySpan<char> buffer);
public virtual void WriteLine (ReadOnlySpan<char> buffer);
abstract member WriteLine : ReadOnlySpan<char> -> unit
override this.WriteLine : ReadOnlySpan<char> -> unit
Public Overridable Sub WriteLine (buffer As ReadOnlySpan(Of Char))

매개 변수

buffer
ReadOnlySpan<Char>

텍스트 스트림에 쓸 문자 범위 값입니다.The char span value to write to the text stream.

설명

지정 된 값의 텍스트 표현은 ReadOnlySpan를 호출 하 여 생성 됩니다 . ToString 메서드.The text representation of the specified value is produced by calling the ReadOnlySpan.ToString method.

줄 종결자는 필드에 의해 정의 됩니다 CoreNewLine .The line terminator is defined by the CoreNewLine field.

일반적인 i/o 작업 목록은 일반적인 I/o 작업을 참조 하세요.For a list of common I/O tasks, see Common I/O Tasks.

적용 대상