다음을 통해 공유


TextWriter.Write 메서드

정의

데이터를 텍스트 스트림에 씁니다.

오버로드

Write(String, Object, Object, Object)

Format(String, Object, Object, Object) 메서드와 동일한 의미 체계를 사용하여 서식이 지정된 문자열을 텍스트 스트림에 씁니다.

Write(Char[], Int32, Int32)

문자의 하위 배열을 텍스트 스트림에 씁니다.

Write(String, ReadOnlySpan<Object>)

Format(String, ReadOnlySpan<Object>)동일한 의미 체계를 사용하여 서식이 지정된 문자열을 텍스트 스트림에 씁니다.

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)

해당 개체에서 ToString 메서드를 호출하여 텍스트 스트림에 개체의 텍스트 표현을 씁니다.

Write(Int64)

텍스트 스트림에 부가된 8 바이트 정수의 텍스트 표현을 씁니다.

Write(Int32)

텍스트 스트림에 부가된 4 바이트 정수의 텍스트 표현을 씁니다.

Write(Double)

8 바이트 부동 소수점 값의 텍스트 표현을 텍스트 스트림에 씁니다.

Write(Decimal)

10진수 값의 텍스트 표현을 텍스트 스트림에 씁니다.

Write(Char[])

텍스트 스트림에 문자 배열을 씁니다.

Write(Char)

텍스트 스트림에 문자를 씁니다.

Write(Boolean)

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.

I/O 오류가 발생합니다.

format 유효한 복합 형식 문자열이 아닙니다.

-또는-

서식 항목의 인덱스가 0보다 작거나 서식을 지정할 개체 수보다 크거나 같습니다(이 메서드 오버로드의 경우 3개임).

설명

이 메서드는 복합 서식을 사용하여 개체 값을 해당 문자열 표현으로 변환하고 해당 표현을 문자열에 포함합니다. .NET은 다음 서식 지정 항목에서 자세히 설명하는 광범위한 서식 지정 지원을 제공합니다.

  • 복합 서식 지정 기능에 대한 자세한 내용은 복합 서식참조하세요.

  • 숫자 서식 지정자에 대한 자세한 내용은 표준 숫자 서식 문자열사용자 지정 숫자 서식 문자열참조하세요.

  • 날짜 및 시간 형식 지정자에 대한 자세한 내용은 표준 날짜 및 시간 서식 문자열 사용자 지정 날짜 및 시간 형식 문자열참조하세요.

  • 열거형 서식 지정자에 대한 자세한 내용은 열거형 형식 문자열참조하세요.

  • 서식 지정에 대한 자세한 내용은 형식참조하세요.

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

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

{인덱스[,길이][:formatString]}

대괄호 안의 요소는 선택 사항입니다. 다음 표에서는 각 요소에 대해 설명합니다. 서식 항목의 구문을 포함하여 복합 서식 지정 기능에 대한 자세한 내용은 복합 서식 지정참조하세요.

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

선행 및 후행 중괄호 문자인 "{" 및 "}"가 필요합니다. 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 음수입니다.

I/O 오류가 발생합니다.

설명

이 메서드는 위치 index시작하는 buffer 문자 배열에서 이 TextWriter 데이터의 count 문자를 씁니다.

이 오버로드는 index (index + count) 사이의 buffer 각 문자에 대한 Write(Char[]) 오버로드와 동일합니다.

일반적인 I/O 작업 목록은 일반적인 I/O 작업참조하세요.

추가 정보

적용 대상

Write(String, ReadOnlySpan<Object>)

Format(String, ReadOnlySpan<Object>)동일한 의미 체계를 사용하여 서식이 지정된 문자열을 텍스트 스트림에 씁니다.

public:
 virtual void Write(System::String ^ format, ReadOnlySpan<System::Object ^> arg);
public virtual void Write (string format, scoped ReadOnlySpan<object?> arg);
abstract member Write : string * ReadOnlySpan<obj> -> unit
override this.Write : string * ReadOnlySpan<obj> -> unit
Public Overridable Sub Write (format As String, arg As ReadOnlySpan(Of Object))

매개 변수

format
String

복합 형식 문자열입니다.

arg
ReadOnlySpan<Object>

서식을 지정하고 쓸 개체가 0개 이상 포함된 개체 범위입니다.

적용 대상

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 또는 argnull.

I/O 오류가 발생합니다.

format 유효한 복합 형식 문자열이 아닙니다.

-또는-

형식 항목의 인덱스가 0보다 작거나 arg 배열의 길이보다 크거나 같습니다.

설명

이 메서드는 복합 서식을 사용하여 개체 값을 해당 문자열 표현으로 변환하고 해당 표현을 문자열에 포함합니다. .NET은 다음 서식 지정 항목에서 자세히 설명하는 광범위한 서식 지정 지원을 제공합니다.

  • 복합 서식 지정 기능에 대한 자세한 내용은 복합 서식참조하세요.

  • 숫자 서식 지정자에 대한 자세한 내용은 표준 숫자 서식 문자열사용자 지정 숫자 서식 문자열참조하세요.

  • 날짜 및 시간 형식 지정자에 대한 자세한 내용은 표준 날짜 및 시간 서식 문자열 사용자 지정 날짜 및 시간 형식 문자열참조하세요.

  • 열거형 서식 지정자에 대한 자세한 내용은 열거형 형식 문자열참조하세요.

  • 서식 지정에 대한 자세한 내용은 형식참조하세요.

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

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

{인덱스[,길이][:formatString]}

대괄호 안의 요소는 선택 사항입니다. 다음 표에서는 각 요소에 대해 설명합니다. 서식 항목의 구문을 포함하여 복합 서식 지정 기능에 대한 자세한 내용은 복합 서식 지정참조하세요.

요소 묘사
색인 서식을 지정할 개체의 매개 변수 목록에서 0부터 시작하는 위치입니다. 인덱스 지정한 개체가 null경우 서식 항목은 String.Empty바뀝다. 이 오버로드에는 매개 변수 목록에 배열이 있으므로 인덱스 값은 항상 배열의 길이보다 작아야 합니다. 인덱스 위치에 매개 변수가 없으면 FormatException throw됩니다.
,길이 매개 변수의 문자열 표현에서 최소 문자 수입니다. 양수이면 매개 변수가 오른쪽에 맞춰집니다. 음수이면 왼쪽 맞춤입니다.
:formatString 서식을 지정할 개체에서 지원하는 표준 또는 사용자 지정 형식 문자열입니다. formatString 가능한 값은 개체의 ToString(string format) 메서드에서 지원하는 값과 동일합니다. formatString 지정하지 않고 서식을 지정할 개체가 IFormattable 인터페이스를 구현하는 경우 nullIFormattable.ToString 서식 문자열로 사용되는 format 매개 변수의 값으로 전달됩니다.

선행 및 후행 중괄호 문자인 "{" 및 "}"가 필요합니다. 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.

I/O 오류가 발생합니다.

format 유효한 복합 형식 문자열이 아닙니다.

-또는-

서식 항목의 인덱스가 0보다 작거나 서식을 지정할 개체 수보다 크거나 같습니다(이 메서드 오버로드의 경우 1).

설명

이 메서드는 복합 서식을 사용하여 개체 값을 해당 문자열 표현으로 변환하고 해당 표현을 문자열에 포함합니다. .NET은 다음 서식 지정 항목에서 자세히 설명하는 광범위한 서식 지정 지원을 제공합니다.

  • 복합 서식 지정 기능에 대한 자세한 내용은 복합 서식참조하세요.

  • 숫자 서식 지정자에 대한 자세한 내용은 표준 숫자 서식 문자열사용자 지정 숫자 서식 문자열참조하세요.

  • 날짜 및 시간 형식 지정자에 대한 자세한 내용은 표준 날짜 및 시간 서식 문자열 사용자 지정 날짜 및 시간 형식 문자열참조하세요.

  • 열거형 서식 지정자에 대한 자세한 내용은 열거형 형식 문자열참조하세요.

  • 서식 지정에 대한 자세한 내용은 형식참조하세요.

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

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

{인덱스[,길이][:formatString]}

대괄호 안의 요소는 선택 사항입니다. 다음 표에서는 각 요소에 대해 설명합니다. 서식 항목의 구문을 포함하여 복합 서식 지정 기능에 대한 자세한 내용은 복합 서식 지정참조하세요.

요소 묘사
색인 서식을 지정할 개체의 매개 변수 목록에서 0부터 시작하는 위치입니다. 인덱스 지정한 개체가 null경우 서식 항목은 String.Empty바뀝다. 이 오버로드에는 매개 변수 목록에 단일 개체만 있으므로 인덱스 값은 항상 0이어야 합니다. 인덱스 위치에 매개 변수가 없으면 FormatException throw됩니다.
,길이 매개 변수의 문자열 표현에서 최소 문자 수입니다. 양수이면 매개 변수가 오른쪽에 맞춰집니다. 음수이면 왼쪽 맞춤입니다.
:formatString 서식을 지정할 개체에서 지원하는 표준 또는 사용자 지정 형식 문자열입니다. formatString 가능한 값은 개체의 ToString(string format) 메서드에서 지원하는 값과 동일합니다. formatString 지정하지 않고 서식을 지정할 개체가 IFormattable 인터페이스를 구현하는 경우 nullIFormattable.ToString 서식 문자열로 사용되는 format 매개 변수의 값으로 전달됩니다.

선행 및 후행 중괄호 문자인 "{" 및 "}"가 필요합니다. 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 바이트 부호 없는 정수입니다.

특성

예외

I/O 오류가 발생합니다.

설명

지정된 값의 텍스트 표현은 UInt64.ToString 메서드를 호출하여 생성됩니다. null않은 경우 TextWriter.FormatProvider 속성은 문화권별 서식을 지정합니다.

일반적인 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 바이트 부호 없는 정수입니다.

특성

예외

I/O 오류가 발생합니다.

설명

지정된 값의 텍스트 표현은 UInt32.ToString 메서드를 호출하여 생성됩니다. null않은 경우 TextWriter.FormatProvider 속성은 문화권별 서식을 지정합니다.

일반적인 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

쓸 문자열입니다.

예외

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 바이트 부동 소수점 값입니다.

예외

I/O 오류가 발생합니다.

설명

지정된 값의 텍스트 표현은 Single.ToString 메서드를 호출하여 생성됩니다. null않은 경우 TextWriter.FormatProvider 속성은 문화권별 서식을 지정합니다.

일반적인 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.

I/O 오류가 발생합니다.

format 유효한 복합 형식 문자열이 아닙니다.

-또는-

서식 항목의 인덱스가 0보다 작거나 서식을 지정할 개체 수보다 크거나 같습니다(이 메서드 오버로드의 경우 두 개임).

설명

이 메서드는 복합 서식을 사용하여 개체 값을 해당 문자열 표현으로 변환하고 해당 표현을 문자열에 포함합니다. .NET은 다음 서식 지정 항목에서 자세히 설명하는 광범위한 서식 지정 지원을 제공합니다.

  • 복합 서식 지정 기능에 대한 자세한 내용은 복합 서식참조하세요.

  • 숫자 서식 지정자에 대한 자세한 내용은 표준 숫자 서식 문자열사용자 지정 숫자 서식 문자열참조하세요.

  • 날짜 및 시간 형식 지정자에 대한 자세한 내용은 표준 날짜 및 시간 서식 문자열 사용자 지정 날짜 및 시간 형식 문자열참조하세요.

  • 열거형 서식 지정자에 대한 자세한 내용은 열거형 형식 문자열참조하세요.

  • 서식 지정에 대한 자세한 내용은 형식참조하세요.

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

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

{인덱스[,길이][:formatString]}

대괄호 안의 요소는 선택 사항입니다. 다음 표에서는 각 요소에 대해 설명합니다. 서식 항목의 구문을 포함하여 복합 서식 지정 기능에 대한 자세한 내용은 복합 서식 지정참조하세요.

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

선행 및 후행 중괄호 문자인 "{" 및 "}"가 필요합니다. 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

쓸 개체입니다.

예외

I/O 오류가 발생합니다.

설명

이 오버로드는 Write(String) 오버로드와 동일합니다.

지정된 개체가 null경우 아무 작업도 수행되지 않으며 예외가 throw되지 않습니다. 그렇지 않으면 문자열 표현을 생성하기 위해 개체의 ToString 메서드가 호출되고 결과 문자열이 출력 스트림에 기록됩니다. null않은 경우 FormatProvider 속성은 문화권별 서식을 지정합니다.

일반적인 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 바이트 부록 정수입니다.

예외

I/O 오류가 발생합니다.

설명

지정된 값의 텍스트 표현은 Int64.ToString 메서드를 호출하여 생성됩니다. null않은 경우 TextWriter.FormatProvider 속성은 문화권별 서식을 지정합니다.

일반적인 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 바이트 부록 정수입니다.

예외

I/O 오류가 발생합니다.

설명

지정된 값의 텍스트 표현은 Int32.ToString 메서드를 호출하여 생성됩니다. null않은 경우 TextWriter.FormatProvider 속성은 문화권별 서식을 지정합니다.

일반적인 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 바이트 부동 소수점 값입니다.

예외

I/O 오류가 발생합니다.

설명

지정된 값의 텍스트 표현은 Double.ToString 메서드를 호출하여 생성됩니다. null않은 경우 TextWriter.FormatProvider 속성은 문화권별 서식을 지정합니다.

일반적인 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진수 값입니다.

예외

I/O 오류가 발생합니다.

설명

null않은 경우 FormatProvider 속성은 문화권별 서식을 지정합니다.

추가 정보

적용 대상

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[]

텍스트 스트림에 쓸 문자 배열입니다.

예외

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

텍스트 스트림에 쓸 문자입니다.

예외

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 값입니다.

예외

I/O 오류가 발생합니다.

설명

지정된 값의 텍스트 표현은 Boolean.ToString 메서드를 호출하여 생성됩니다.

이 메서드는 Boolean.TrueString 또는 Boolean.FalseString출력합니다.

일반적인 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 작업참조하세요.

적용 대상