TextWriter.Write 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
텍스트 스트림에 데이터를 씁니다.
오버로드
Write(String, Object, Object, Object) |
Format(String, Object, Object, Object) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열을 텍스트 스트림에 씁니다. |
Write(Char[], Int32, Int32) |
텍스트 스트림에 문자의 하위 배열을 씁니다. |
Write(String, Object[]) |
Format(String, Object[]) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열을 텍스트 스트림에 씁니다. |
Write(String, Object) |
Format(String, Object) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열을 텍스트 스트림에 씁니다. |
Write(UInt64) |
부호 없는 8바이트 정수의 텍스트 표현을 텍스트 스트림에 씁니다. |
Write(UInt32) |
부호 없는 4바이트 정수의 텍스트 표현을 텍스트 스트림에 씁니다. |
Write(StringBuilder) |
텍스트 스트림에 문자열 작성기를 씁니다. |
Write(String) |
텍스트 스트림에 문자열을 씁니다. |
Write(Single) |
4바이트 부동 소수점 값의 텍스트 표현을 텍스트 스트림에 씁니다. |
Write(String, Object, Object) |
Format(String, Object, Object) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열을 텍스트 스트림에 씁니다. |
Write(Object) |
개체에 대해 |
Write(Int64) |
부호 있는 8바이트 정수의 텍스트 표현을 텍스트 스트림에 씁니다. |
Write(Int32) |
부호 있는 4바이트 정수의 텍스트 표현을 텍스트 스트림에 씁니다. |
Write(Double) |
8바이트 부동 소수점 값의 텍스트 표현을 텍스트 스트림에 씁니다. |
Write(Decimal) |
10진수 값의 텍스트 표현을 텍스트 스트림에 씁니다. |
Write(Char[]) |
텍스트 스트림에 문자 배열을 씁니다. |
Write(Char) |
텍스트 스트림에 문자를 씁니다. |
Write(Boolean) |
|
Write(ReadOnlySpan<Char>) |
텍스트 스트림에 문자 범위를 씁니다. |
Write(String, Object, Object, Object)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Format(String, Object, Object, Object) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열을 텍스트 스트림에 씁니다.
public:
virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);
public virtual void Write (string format, object arg0, object arg1, object arg2);
public virtual void Write (string format, object? arg0, object? arg1, object? arg2);
abstract member Write : string * obj * obj * obj -> unit
override this.Write : string * obj * obj * obj -> unit
Public Overridable Sub Write (format As String, arg0 As Object, arg1 As Object, arg2 As Object)
매개 변수
- format
- String
복합 형식 문자열입니다.
- arg0
- Object
서식을 지정하고 쓸 첫 번째 개체입니다.
- arg1
- Object
서식을 지정하고 쓸 두 번째 개체입니다.
- arg2
- Object
서식을 지정하고 쓸 세 번째 개체입니다.
예외
format
이(가) null
인 경우
TextWriter가 닫혔습니다.
I/O 오류가 발생했습니다.
format
이 유효한 합성 서식 문자열이 아닙니다.
또는
형식 항목의 인덱스가 0보다 작거나, 형식을 지정할 개체의 수보다 크거나 같은 경우입니다. 즉, 이 메서드 오버로드의 경우는 3입니다.
설명
이 메서드는 복합 서식을 사용하여 개체의 값을 문자열 표현으로 변환하고 해당 표현을 문자열에 포함합니다. .NET은 다음과 같은 서식 지정 topics 자세히 설명하는 광범위한 서식 지정 지원을 제공합니다.
복합 서식 지정 기능에 대한 자세한 내용은 복합 서식 지정을 참조하세요.
숫자 형식 지정자에 대한 자세한 내용은 표준 숫자 형식 문자열 및사용자 지정 숫자 형식 문자열을 참조하세요.
날짜 및 시간 형식 지정자에 대한 자세한 내용은 표준 날짜 및 시간 형식 문자열 및사용자 지정 날짜 및 시간 형식 문자열을 참조하세요.
열거형 형식 지정자에 대한 자세한 내용은 열거형 형식 문자열을 참조하세요.
서식 지정에 대한 자세한 내용은 형식 서식 지정을 참조하세요.
매개 변수는 format
이 메서드의 매개 변수 목록에 있는 개체에 해당하는 형식 항목이라고 하는 0개 이상의 인덱싱된 자리 표시자와 혼합된 텍스트의 0개 이상의 실행으로 구성됩니다. 서식 지정 프로세스는 각 서식 항목을 해당 개체 값의 문자열 표현으로 바꿉니다.
형식 항목의 구문은 다음과 같습니다.
{index[,length][:formatString]}
대괄호 안의 요소는 선택 사항입니다. 다음 표에서는 각 요소에 대해 설명합니다. 서식 항목의 구문을 포함하여 복합 서식 지정 기능에 대한 자세한 내용은 복합 서식 지정을 참조하세요.
요소 | Description |
---|---|
인덱스 | 서식을 지정할 개체의 매개 변수 목록에서 0부터 시작하는 위치입니다. 인덱스로 지정된 개체가 이null 면 형식 항목이 로 String.Empty대체됩니다. 이 오버로드에는 매개 변수 목록에 세 개의 개체가 있으므로 인덱 스 값은 항상 0, 1 또는 2여야 합니다. 인덱스 위치에 매개 변수가 없으면 이 FormatException throw됩니다. |
,length | 매개 변수의 문자열 표현에서 최소 문자 수입니다. 양수이면 매개 변수가 오른쪽에 맞춰집니다. 음수이면 왼쪽 맞춤입니다. |
:formatString | 서식을 지정할 개체에서 지원하는 표준 또는 사용자 지정 서식 문자열입니다. formatString에 사용할 수 있는 값은 개체의 ToString(string format) 메서드에서 지원하는 값과 동일합니다. formatString을 지정하지 않고 서식을 지정할 개체가 인터페이스 null 를 IFormattable 구현하는 경우 는 형식 문자열로 사용되는 매개 변수의 format 값으로 IFormattable.ToString 전달됩니다. |
선행 및 후행 중괄호 문자인 "{" 및 "}"가 필요합니다. 에서 format
단일 리터럴 중괄호 문자를 지정하려면 두 개의 선행 또는 후행 중괄호 문자("{{" 또는 "}}")를 지정합니다.
이 메서드는 지정된 문자열에서 개별 줄 바꿈 문자(16진수 0x000a)를 검색하지 않고 로 TextWriter.NewLine바꿉니다.
지정된 개체가 형식 문자열에서 참조되지 않으면 무시됩니다.
일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.
추가 정보
적용 대상
Write(Char[], Int32, Int32)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
텍스트 스트림에 문자의 하위 배열을 씁니다.
public:
virtual void Write(cli::array <char> ^ buffer, int index, int count);
public virtual void Write (char[] buffer, int index, int count);
abstract member Write : char[] * int * int -> unit
override this.Write : char[] * int * int -> unit
Public Overridable Sub Write (buffer As Char(), index As Integer, count As Integer)
매개 변수
- buffer
- Char[]
쓸 데이터가 있는 문자 배열입니다.
- index
- Int32
데이터 검색을 시작하는 버퍼의 문자 위치입니다.
- count
- Int32
쓸 문자 수입니다.
예외
버퍼 길이에서 index
를 빼면 count
보다 작습니다.
buffer
매개 변수가 null
인 경우
index
또는 count
가 음수입니다.
TextWriter가 닫혔습니다.
I/O 오류가 발생했습니다.
설명
이 메서드는 위치에서 index
시작하는 문자 배열에서 buffer
데이터의 문자를 이 TextWriter
에 씁니다count
.
이 오버로드는 및 (index
count
+ ) 사이의 index
각 문자에 buffer
대한 오버로드와 동일합니다.Write(Char[])
일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.
추가 정보
적용 대상
Write(String, Object[])
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Format(String, Object[]) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열을 텍스트 스트림에 씁니다.
public:
virtual void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public virtual void Write (string format, params object[] arg);
public virtual void Write (string format, params object?[] arg);
abstract member Write : string * obj[] -> unit
override this.Write : string * obj[] -> unit
Public Overridable Sub Write (format As String, ParamArray arg As Object())
매개 변수
- format
- String
복합 형식 문자열입니다.
- arg
- Object[]
서식을 지정하고 쓸 개체를 0개 이상 포함하는 개체 배열입니다.
예외
format
또는 arg
가 null
인 경우
TextWriter가 닫혔습니다.
I/O 오류가 발생했습니다.
설명
이 메서드는 복합 서식을 사용하여 개체의 값을 문자열 표현으로 변환하고 해당 표현을 문자열에 포함합니다. .NET은 다음과 같은 서식 지정 topics 자세히 설명하는 광범위한 서식 지정 지원을 제공합니다.
복합 서식 지정 기능에 대한 자세한 내용은 복합 서식 지정을 참조하세요.
숫자 형식 지정자에 대한 자세한 내용은 표준 숫자 형식 문자열 및사용자 지정 숫자 형식 문자열을 참조하세요.
날짜 및 시간 형식 지정자에 대한 자세한 내용은 표준 날짜 및 시간 형식 문자열 및사용자 지정 날짜 및 시간 형식 문자열을 참조하세요.
열거형 형식 지정자에 대한 자세한 내용은 열거형 형식 문자열을 참조하세요.
서식 지정에 대한 자세한 내용은 형식 서식 지정을 참조하세요.
매개 변수는 format
이 메서드의 매개 변수 목록에 있는 개체에 해당하는 형식 항목이라고 하는 0개 이상의 인덱싱된 자리 표시자와 혼합된 텍스트의 0개 이상의 실행으로 구성됩니다. 서식 지정 프로세스는 각 서식 항목을 해당 개체 값의 문자열 표현으로 바꿉니다.
형식 항목의 구문은 다음과 같습니다.
{index[,length][:formatString]}
대괄호 안의 요소는 선택 사항입니다. 다음 표에서는 각 요소에 대해 설명합니다. 서식 항목의 구문을 포함하여 복합 서식 지정 기능에 대한 자세한 내용은 복합 서식 지정을 참조하세요.
요소 | Description |
---|---|
인덱스 | 서식을 지정할 개체의 매개 변수 목록에서 0부터 시작하는 위치입니다. 인덱스로 지정된 개체가 이null 면 형식 항목이 로 String.Empty대체됩니다. 이 오버로드의 매개 변수 목록에 배열이 있으므로 인덱 스 값은 항상 배열의 길이보다 작아야 합니다. 인덱스 위치에 매개 변수가 없으면 이 FormatException throw됩니다. |
,length | 매개 변수의 문자열 표현에서 최소 문자 수입니다. 양수이면 매개 변수가 오른쪽에 맞춰집니다. 음수이면 왼쪽 맞춤입니다. |
:formatString | 서식을 지정할 개체에서 지원하는 표준 또는 사용자 지정 서식 문자열입니다. formatString에 사용할 수 있는 값은 개체의 ToString(string format) 메서드에서 지원하는 값과 동일합니다. formatString을 지정하지 않고 서식을 지정할 개체가 인터페이스 null 를 IFormattable 구현하는 경우 는 형식 문자열로 사용되는 매개 변수의 format 값으로 IFormattable.ToString 전달됩니다. |
선행 및 후행 중괄호 문자인 "{" 및 "}"가 필요합니다. 에서 format
단일 리터럴 중괄호 문자를 지정하려면 두 개의 선행 또는 후행 중괄호 문자("{{" 또는 "}}")를 지정합니다.
이 메서드는 지정된 문자열에서 개별 줄 바꿈 문자(16진수 0x000a)를 검색하지 않고 로 TextWriter.NewLine바꿉니다.
지정된 개체가 형식 문자열에서 참조되지 않으면 무시됩니다.
일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.
추가 정보
적용 대상
Write(String, Object)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Format(String, Object) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열을 텍스트 스트림에 씁니다.
public:
virtual void Write(System::String ^ format, System::Object ^ arg0);
public virtual void Write (string format, object arg0);
public virtual void Write (string format, object? arg0);
abstract member Write : string * obj -> unit
override this.Write : string * obj -> unit
Public Overridable Sub Write (format As String, arg0 As Object)
매개 변수
- format
- String
복합 형식 문자열입니다.
- arg0
- Object
서식을 지정하고 쓸 개체입니다.
예외
format
이(가) null
인 경우
TextWriter가 닫혔습니다.
I/O 오류가 발생했습니다.
format
이 유효한 합성 서식 문자열이 아닙니다.
또는
형식 항목의 인덱스가 0보다 작거나, 형식을 지정할 개체의 수보다 크거나 같은 경우입니다. 즉, 이 메서드 오버로드의 경우는 1입니다.
설명
이 메서드는 복합 서식을 사용하여 개체의 값을 문자열 표현으로 변환하고 해당 표현을 문자열에 포함합니다. .NET은 다음과 같은 서식 지정 topics 자세히 설명하는 광범위한 서식 지정 지원을 제공합니다.
복합 서식 지정 기능에 대한 자세한 내용은 복합 서식 지정을 참조하세요.
숫자 형식 지정자에 대한 자세한 내용은 표준 숫자 형식 문자열 및사용자 지정 숫자 형식 문자열을 참조하세요.
날짜 및 시간 형식 지정자에 대한 자세한 내용은 표준 날짜 및 시간 형식 문자열 및사용자 지정 날짜 및 시간 형식 문자열을 참조하세요.
열거형 형식 지정자에 대한 자세한 내용은 열거형 형식 문자열을 참조하세요.
서식 지정에 대한 자세한 내용은 형식 서식 지정을 참조하세요.
매개 변수는 format
이 메서드의 매개 변수 목록에 있는 개체에 해당하는 형식 항목이라고 하는 0개 이상의 인덱싱된 자리 표시자와 혼합된 텍스트의 0개 이상의 실행으로 구성됩니다. 서식 지정 프로세스는 각 서식 항목을 해당 개체 값의 문자열 표현으로 바꿉니다.
형식 항목의 구문은 다음과 같습니다.
{index[,length][:formatString]}
대괄호 안의 요소는 선택 사항입니다. 다음 표에서는 각 요소에 대해 설명합니다. 서식 항목의 구문을 포함하여 복합 서식 지정 기능에 대한 자세한 내용은 복합 서식 지정을 참조하세요.
요소 | Description |
---|---|
인덱스 | 서식을 지정할 개체의 매개 변수 목록에서 0부터 시작하는 위치입니다. 인덱스로 지정된 개체가 이null 면 형식 항목이 로 String.Empty대체됩니다. 이 오버로드는 매개 변수 목록에 단일 개체만 있으므로 인덱 스 값은 항상 0이어야 합니다. 인덱스 위치에 매개 변수가 없으면 이 FormatException throw됩니다. |
,length | 매개 변수의 문자열 표현에서 최소 문자 수입니다. 양수이면 매개 변수가 오른쪽에 맞춰집니다. 음수이면 왼쪽 맞춤입니다. |
:formatString | 서식을 지정할 개체에서 지원하는 표준 또는 사용자 지정 서식 문자열입니다. formatString에 사용할 수 있는 값은 개체의 ToString(string format) 메서드에서 지원하는 값과 동일합니다. formatString을 지정하지 않고 서식을 지정할 개체가 인터페이스 null 를 IFormattable 구현하는 경우 는 형식 문자열로 사용되는 매개 변수의 format 값으로 IFormattable.ToString 전달됩니다. |
선행 및 후행 중괄호 문자인 "{" 및 "}"가 필요합니다. 에서 format
단일 리터럴 중괄호 문자를 지정하려면 두 개의 선행 또는 후행 중괄호 문자("{{" 또는 "}}")를 지정합니다.
이 메서드는 지정된 문자열에서 개별 줄 바꿈 문자(16진수 0x000a)를 검색하지 않고 로 TextWriter.NewLine바꿉니다.
지정된 개체가 형식 문자열에서 참조되지 않으면 무시됩니다.
일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.
추가 정보
적용 대상
Write(UInt64)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
중요
이 API는 CLS 규격이 아닙니다.
부호 없는 8바이트 정수의 텍스트 표현을 텍스트 스트림에 씁니다.
public:
virtual void Write(System::UInt64 value);
[System.CLSCompliant(false)]
public virtual void Write (ulong value);
[<System.CLSCompliant(false)>]
abstract member Write : uint64 -> unit
override this.Write : uint64 -> unit
Public Overridable Sub Write (value As ULong)
매개 변수
- value
- UInt64
쓸 부호 없는 8바이트 정수입니다.
- 특성
예외
TextWriter가 닫혔습니다.
I/O 오류가 발생했습니다.
설명
지정된 값의 텍스트 표현은 메서드를 호출 UInt64.ToString 하여 생성됩니다. 속성이 TextWriter.FormatProvider 아닌 null
경우 문화권별 서식을 지정합니다.
일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.
추가 정보
적용 대상
Write(UInt32)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
중요
이 API는 CLS 규격이 아닙니다.
부호 없는 4바이트 정수의 텍스트 표현을 텍스트 스트림에 씁니다.
public:
virtual void Write(System::UInt32 value);
[System.CLSCompliant(false)]
public virtual void Write (uint value);
[<System.CLSCompliant(false)>]
abstract member Write : uint32 -> unit
override this.Write : uint32 -> unit
Public Overridable Sub Write (value As UInteger)
매개 변수
- value
- UInt32
쓸 부호 없는 4바이트 정수입니다.
- 특성
예외
TextWriter가 닫혔습니다.
I/O 오류가 발생했습니다.
설명
지정된 값의 텍스트 표현은 메서드를 호출 UInt32.ToString 하여 생성됩니다. 속성이 TextWriter.FormatProvider 아닌 null
경우 문화권별 서식을 지정합니다.
일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.
추가 정보
적용 대상
Write(StringBuilder)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
텍스트 스트림에 문자열 작성기를 씁니다.
public:
virtual void Write(System::Text::StringBuilder ^ value);
public virtual void Write (System.Text.StringBuilder? value);
abstract member Write : System.Text.StringBuilder -> unit
override this.Write : System.Text.StringBuilder -> unit
Public Overridable Sub Write (value As StringBuilder)
매개 변수
- value
- StringBuilder
텍스트 스트림에 문자열 작성기로 쓸 문자열입니다.
설명
이 메서드는 와 동일 Write(stringBuilder.ToString())
하지만 중간 문자열을 StringBuilder.GetChunks 만들지 않도록 메서드를 사용합니다.
적용 대상
Write(String)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
텍스트 스트림에 문자열을 씁니다.
public:
virtual void Write(System::String ^ value);
public virtual void Write (string value);
public virtual void Write (string? value);
abstract member Write : string -> unit
override this.Write : string -> unit
Public Overridable Sub Write (value As String)
매개 변수
- value
- String
쓸 문자열입니다.
예외
TextWriter가 닫혔습니다.
I/O 오류가 발생했습니다.
설명
이 오버로드는 오버로드와 Write(Char[]) 동일합니다.
이 메서드는 지정된 문자열에서 개별 줄 바꿈 문자(16진수 0x000a)를 검색하지 않고 로 TextWriter.NewLine바꿉니다.
value
가 null
이면 텍스트 스트림에 아무 것도 쓰지 않습니다.
일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.
추가 정보
적용 대상
Write(Single)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
4바이트 부동 소수점 값의 텍스트 표현을 텍스트 스트림에 씁니다.
public:
virtual void Write(float value);
public virtual void Write (float value);
abstract member Write : single -> unit
override this.Write : single -> unit
Public Overridable Sub Write (value As Single)
매개 변수
- value
- Single
쓸 4바이트 부동 소수점 값입니다.
예외
TextWriter가 닫혔습니다.
I/O 오류가 발생했습니다.
설명
지정된 값의 텍스트 표현은 메서드를 호출 Single.ToString 하여 생성됩니다. 속성이 TextWriter.FormatProvider 아닌 null
경우 문화권별 서식을 지정합니다.
일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.
추가 정보
적용 대상
Write(String, Object, Object)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Format(String, Object, Object) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열을 텍스트 스트림에 씁니다.
public:
virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public virtual void Write (string format, object arg0, object arg1);
public virtual void Write (string format, object? arg0, object? arg1);
abstract member Write : string * obj * obj -> unit
override this.Write : string * obj * obj -> unit
Public Overridable Sub Write (format As String, arg0 As Object, arg1 As Object)
매개 변수
- format
- String
복합 형식 문자열입니다.
- arg0
- Object
서식을 지정하고 쓸 첫 번째 개체입니다.
- arg1
- Object
서식을 지정하고 쓸 두 번째 개체입니다.
예외
format
이(가) null
인 경우
TextWriter가 닫혔습니다.
I/O 오류가 발생했습니다.
format
이 유효한 합성 서식 문자열이 아닙니다.
또는
형식 항목의 인덱스가 0보다 작거나, 형식을 지정할 개체의 수보다 크거나 같은 경우입니다. 즉, 이 메서드 오버로드의 경우는 2입니다.
설명
이 메서드는 복합 서식을 사용하여 개체의 값을 문자열 표현으로 변환하고 해당 표현을 문자열에 포함합니다. .NET은 다음과 같은 서식 지정 topics 자세히 설명하는 광범위한 서식 지정 지원을 제공합니다.
복합 서식 지정 기능에 대한 자세한 내용은 복합 서식 지정을 참조하세요.
숫자 형식 지정자에 대한 자세한 내용은 표준 숫자 형식 문자열 및사용자 지정 숫자 형식 문자열을 참조하세요.
날짜 및 시간 형식 지정자에 대한 자세한 내용은 표준 날짜 및 시간 형식 문자열 및사용자 지정 날짜 및 시간 형식 문자열을 참조하세요.
열거형 형식 지정자에 대한 자세한 내용은 열거형 형식 문자열을 참조하세요.
서식 지정에 대한 자세한 내용은 형식 서식 지정을 참조하세요.
매개 변수는 format
이 메서드의 매개 변수 목록에 있는 개체에 해당하는 형식 항목이라고 하는 0개 이상의 인덱싱된 자리 표시자와 혼합된 텍스트의 0개 이상의 실행으로 구성됩니다. 서식 지정 프로세스는 각 서식 항목을 해당 개체 값의 문자열 표현으로 바꿉니다.
형식 항목의 구문은 다음과 같습니다.
{index[,length][:formatString]}
대괄호 안의 요소는 선택 사항입니다. 다음 표에서는 각 요소에 대해 설명합니다. 서식 항목의 구문을 포함하여 복합 서식 지정 기능에 대한 자세한 내용은 복합 서식 지정을 참조하세요.
요소 | Description |
---|---|
인덱스 | 서식을 지정할 개체의 매개 변수 목록에서 0부터 시작하는 위치입니다. 인덱스로 지정된 개체가 이null 면 형식 항목이 로 String.Empty대체됩니다. 이 오버로드에는 매개 변수 목록에 두 개의 개체가 있으므로 인덱 스 값은 항상 0 또는 1이어야 합니다. 인덱스 위치에 매개 변수가 없으면 이 FormatException throw됩니다. |
,length | 매개 변수의 문자열 표현에서 최소 문자 수입니다. 양수이면 매개 변수가 오른쪽에 맞춰집니다. 음수이면 왼쪽 맞춤입니다. |
:formatString | 서식을 지정할 개체에서 지원하는 표준 또는 사용자 지정 서식 문자열입니다. formatString에 사용할 수 있는 값은 개체의 ToString(string format) 메서드에서 지원하는 값과 동일합니다. formatString을 지정하지 않고 서식을 지정할 개체가 인터페이스 null 를 IFormattable 구현하는 경우 는 형식 문자열로 사용되는 매개 변수의 format 값으로 IFormattable.ToString 전달됩니다. |
선행 및 후행 중괄호 문자인 "{" 및 "}"가 필요합니다. 에서 format
단일 리터럴 중괄호 문자를 지정하려면 두 개의 선행 또는 후행 중괄호 문자("{{" 또는 "}}")를 지정합니다.
이 메서드는 지정된 문자열에서 개별 줄 바꿈 문자(16진수 0x000a)를 검색하지 않고 로 TextWriter.NewLine바꿉니다.
지정된 개체가 형식 문자열에서 참조되지 않으면 무시됩니다.
일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.
추가 정보
적용 대상
Write(Object)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
개체에 대해 ToString
메서드를 호출하여 해당 개체의 텍스트 표현을 텍스트 스트림에 씁니다.
public:
virtual void Write(System::Object ^ value);
public virtual void Write (object value);
public virtual void Write (object? value);
abstract member Write : obj -> unit
override this.Write : obj -> unit
Public Overridable Sub Write (value As Object)
매개 변수
- value
- Object
쓸 개체입니다.
예외
TextWriter가 닫혔습니다.
I/O 오류가 발생했습니다.
설명
이 오버로드는 오버로드와 Write(String) 동일합니다.
지정된 개체가 이 null
면 아무 작업도 수행되지 않으며 예외가 throw되지 않습니다. 그렇지 않으면 문자열 표현을 생성하기 위해 개체의 ToString
메서드가 호출되고 결과 문자열이 출력 스트림에 기록됩니다. 속성이 FormatProvider 아닌 null
경우 문화권별 서식을 지정합니다.
일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.
추가 정보
적용 대상
Write(Int64)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
부호 있는 8바이트 정수의 텍스트 표현을 텍스트 스트림에 씁니다.
public:
virtual void Write(long value);
public virtual void Write (long value);
abstract member Write : int64 -> unit
override this.Write : int64 -> unit
Public Overridable Sub Write (value As Long)
매개 변수
- value
- Int64
쓸 부호 있는 8바이트 정수입니다.
예외
TextWriter가 닫혔습니다.
I/O 오류가 발생했습니다.
설명
지정된 값의 텍스트 표현은 메서드를 호출 Int64.ToString 하여 생성됩니다. 속성이 TextWriter.FormatProvider 아닌 null
경우 문화권별 서식을 지정합니다.
일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.
추가 정보
적용 대상
Write(Int32)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
부호 있는 4바이트 정수의 텍스트 표현을 텍스트 스트림에 씁니다.
public:
virtual void Write(int value);
public virtual void Write (int value);
abstract member Write : int -> unit
override this.Write : int -> unit
Public Overridable Sub Write (value As Integer)
매개 변수
- value
- Int32
쓸 부호 있는 4바이트 정수입니다.
예외
TextWriter가 닫혔습니다.
I/O 오류가 발생했습니다.
설명
지정된 값의 텍스트 표현은 메서드를 호출 Int32.ToString 하여 생성됩니다. 속성이 TextWriter.FormatProvider 아닌 null
경우 문화권별 서식을 지정합니다.
일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.
추가 정보
적용 대상
Write(Double)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
8바이트 부동 소수점 값의 텍스트 표현을 텍스트 스트림에 씁니다.
public:
virtual void Write(double value);
public virtual void Write (double value);
abstract member Write : double -> unit
override this.Write : double -> unit
Public Overridable Sub Write (value As Double)
매개 변수
- value
- Double
쓸 8바이트 부동 소수점 값입니다.
예외
TextWriter가 닫혔습니다.
I/O 오류가 발생했습니다.
설명
지정된 값의 텍스트 표현은 메서드를 호출 Double.ToString 하여 생성됩니다. 속성이 TextWriter.FormatProvider 아닌 null
경우 문화권별 서식을 지정합니다.
일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.
추가 정보
적용 대상
Write(Decimal)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
10진수 값의 텍스트 표현을 텍스트 스트림에 씁니다.
public:
virtual void Write(System::Decimal value);
public virtual void Write (decimal value);
abstract member Write : decimal -> unit
override this.Write : decimal -> unit
Public Overridable Sub Write (value As Decimal)
매개 변수
- value
- Decimal
쓸 10진수 값입니다.
예외
TextWriter가 닫혔습니다.
I/O 오류가 발생했습니다.
설명
속성이 FormatProvider 아닌 null
경우 문화권별 서식을 지정합니다.
추가 정보
적용 대상
Write(Char[])
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
텍스트 스트림에 문자 배열을 씁니다.
public:
virtual void Write(cli::array <char> ^ buffer);
public virtual void Write (char[] buffer);
public virtual void Write (char[]? buffer);
abstract member Write : char[] -> unit
override this.Write : char[] -> unit
Public Overridable Sub Write (buffer As Char())
매개 변수
- buffer
- Char[]
텍스트 스트림에 쓸 문자 배열입니다.
예외
TextWriter가 닫혔습니다.
I/O 오류가 발생했습니다.
설명
이 메서드는 지정된 문자열에서 개별 줄 바꿈 문자(16진수 0x000a)를 검색하지 않고 으로 NewLine바꿉니다.
이 기본 메서드는 메서드를 Write(Char[], Int32, Int32) 호출하고 전체 문자 배열을 전달합니다. 문자 배열이 이 null
면 아무 것도 기록되지 않습니다.
일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.
추가 정보
적용 대상
Write(Char)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
텍스트 스트림에 문자를 씁니다.
public:
abstract void Write(char value);
public:
virtual void Write(char value);
public abstract void Write (char value);
public virtual void Write (char value);
abstract member Write : char -> unit
abstract member Write : char -> unit
override this.Write : char -> unit
Public MustOverride Sub Write (value As Char)
Public Overridable Sub Write (value As Char)
매개 변수
- value
- Char
텍스트 스트림에 쓸 문자입니다.
예외
TextWriter가 닫혔습니다.
I/O 오류가 발생했습니다.
설명
이 기본 메서드는 아무 것도 수행하지 않지만 파생 클래스는 메서드를 재정의하여 적절한 기능을 제공할 수 있습니다.
일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.
추가 정보
적용 대상
Write(Boolean)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Boolean
값의 텍스트 표현을 텍스트 스트림에 씁니다.
public:
virtual void Write(bool value);
public virtual void Write (bool value);
abstract member Write : bool -> unit
override this.Write : bool -> unit
Public Overridable Sub Write (value As Boolean)
매개 변수
- value
- Boolean
쓸 Boolean
값입니다.
예외
TextWriter가 닫혔습니다.
I/O 오류가 발생했습니다.
설명
지정된 값의 텍스트 표현은 메서드를 호출 Boolean.ToString 하여 생성됩니다.
이 메서드는 또는 Boolean.FalseString를 출력합니다Boolean.TrueString.
일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.
추가 정보
적용 대상
Write(ReadOnlySpan<Char>)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
텍스트 스트림에 문자 범위를 씁니다.
public:
virtual void Write(ReadOnlySpan<char> buffer);
public virtual void Write (ReadOnlySpan<char> buffer);
abstract member Write : ReadOnlySpan<char> -> unit
override this.Write : ReadOnlySpan<char> -> unit
Public Overridable Sub Write (buffer As ReadOnlySpan(Of Char))
매개 변수
- buffer
- ReadOnlySpan<Char>
쓸 문자 범위입니다.
설명
지정한 값의 텍스트 표현은 ReadOnlySpan<Char>를 호출하여 생성됩니다. ToString 메서드.
일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.
적용 대상
.NET
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기