TextWriter クラス

定義

連続する一連の文字を書き込むことができるライターを表します。 このクラスは抽象クラスです。

public ref class TextWriter abstract : IDisposable
public ref class TextWriter abstract : MarshalByRefObject, IAsyncDisposable, IDisposable
public ref class TextWriter abstract : MarshalByRefObject, IDisposable
public abstract class TextWriter : IDisposable
public abstract class TextWriter : MarshalByRefObject, IAsyncDisposable, IDisposable
public abstract class TextWriter : MarshalByRefObject, IDisposable
[System.Serializable]
public abstract class TextWriter : MarshalByRefObject, IDisposable
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class TextWriter : MarshalByRefObject, IDisposable
type TextWriter = class
    interface IDisposable
type TextWriter = class
    inherit MarshalByRefObject
    interface IAsyncDisposable
    interface IDisposable
type TextWriter = class
    inherit MarshalByRefObject
    interface IDisposable
[<System.Serializable>]
type TextWriter = class
    inherit MarshalByRefObject
    interface IDisposable
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type TextWriter = class
    inherit MarshalByRefObject
    interface IDisposable
Public MustInherit Class TextWriter
Implements IDisposable
Public MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDisposable
Public MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IDisposable
継承
TextWriter
継承
派生
属性
実装

TextWriter クラスは抽象クラスです。 そのため、コードではインスタンス化しません。 StreamWriter クラスは TextWriter から派生し、ストリームに書き込むためのメンバーの実装を提供します。 次の例では、WriteLineAsync(String) メソッドを使用して、文字列値で構成される 2 行をテキスト ファイルに書き込む方法を示します。

using System.IO;

namespace ConsoleApplication
{
    class Program4
    {
        static void Main()
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            using (StreamWriter writer = File.CreateText("newfile.txt"))
            {
                await writer.WriteLineAsync("First line of example");
                await writer.WriteLineAsync("and second line");
            }
        }
    }
}
Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Using writer As StreamWriter = File.CreateText("newfile.txt")
            Await writer.WriteLineAsync("First line of example")
            Await writer.WriteLineAsync("and second line")
        End Using
    End Sub
End Module

注釈

TextWriter は、ストリームと文字列にそれぞれ文字を書き込む StreamWriterStringWriterの抽象基底クラスです。 TextWriter のインスタンスを使用して、オブジェクトを文字列に書き込んだり、文字列をファイルに書き込んだり、XML をシリアル化したりします。 TextWriter のインスタンスを使用して、文字列またはストリームに使用するのと同じ API を使用してカスタム バッキング ストアにテキストを書き込んだり、テキスト書式設定のサポートを追加したりすることもできます。

パラメーターとしてプリミティブ データ型を持つ TextWriter のすべての Write メソッドは、値を文字列として書き出します。

既定では、TextWriter はスレッド セーフではありません。 スレッド セーフ ラッパーについては、TextWriter.Synchronized を参照してください。

大事な

この型は、IDisposable インターフェイスを実装します。 この型から派生した型の使用が完了したら、直接または間接的に破棄する必要があります。 型を直接破棄するには、try/catch ブロックでその Dispose メソッドを呼び出します。 間接的に破棄するには、using (C#) や Using (Visual Basic) などの言語コンストラクトを使用します。 詳細については、「iDisposable を実装するオブジェクトの使用」および「IDisposable インターフェイス」トピックの「Dispose」セクションを参照してください。

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。

注意 (実装者)

派生クラスは、TextWriterの便利なインスタンスを作成するために、Write(Char) メソッドを最小限に抑える必要があります。

コンストラクター

TextWriter()

TextWriter クラスの新しいインスタンスを初期化します。

TextWriter(IFormatProvider)

指定した形式プロバイダーを使用して、TextWriter クラスの新しいインスタンスを初期化します。

フィールド

CoreNewLine

この TextWriterに使用される改行文字を格納します。

Null

書き込み可能で読み取りはできないバッキング ストアのない TextWriter を提供します。

プロパティ

Encoding

派生クラスでオーバーライドされると、出力が書き込まれる文字エンコーディングを返します。

FormatProvider

書式設定を制御するオブジェクトを取得します。

NewLine

現在の TextWriterで使用される行ターミネータ文字列を取得または設定します。

メソッド

Close()

現在のライターを閉じ、ライターに関連付けられているシステム リソースを解放します。

CreateBroadcasting(TextWriter[])

writersの各ライターに指定された入力を書き込む TextWriter のインスタンスを作成します。

CreateObjRef(Type)

リモート オブジェクトとの通信に使用されるプロキシの生成に必要なすべての関連情報を含むオブジェクトを作成します。

(継承元 MarshalByRefObject)
Dispose()

TextWriter オブジェクトによって使用されるすべてのリソースを解放します。

Dispose(Boolean)

TextWriter によって使用されるアンマネージ リソースを解放し、必要に応じてマネージド リソースを解放します。

DisposeAsync()

TextWriter オブジェクトによって使用されるすべてのリソースを非同期的に解放します。

Equals(Object)

指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
Flush()

現在のライターのすべてのバッファーをクリアし、バッファー内のデータを基になるデバイスに書き込みます。

FlushAsync()

現在のライターのすべてのバッファーを非同期的にクリアし、バッファー内のデータを基になるデバイスに書き込みます。

FlushAsync(CancellationToken)

現在のライターのすべてのバッファーを非同期的にクリアし、バッファー内のデータを基になるデバイスに書き込みます。

GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetLifetimeService()
古い.

このインスタンスの有効期間ポリシーを制御する現在の有効期間サービス オブジェクトを取得します。

(継承元 MarshalByRefObject)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
InitializeLifetimeService()
古い.

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。

(継承元 MarshalByRefObject)
MemberwiseClone()

現在の Objectの簡易コピーを作成します。

(継承元 Object)
MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。

(継承元 MarshalByRefObject)
Synchronized(TextWriter)

指定した TextWriterの周囲にスレッド セーフラッパーを作成します。

ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)
Write(Boolean)

Boolean 値のテキスト表現をテキスト ストリームに書き込みます。

Write(Char)

テキスト ストリームに文字を書き込みます。

Write(Char[])

文字配列をテキスト ストリームに書き込みます。

Write(Char[], Int32, Int32)

文字のサブ配列をテキスト ストリームに書き込みます。

Write(Decimal)

10 進値のテキスト表現をテキスト ストリームに書き込みます。

Write(Double)

8 バイト浮動小数点値のテキスト表現をテキスト ストリームに書き込みます。

Write(Int32)

4 バイト符号付き整数のテキスト表現をテキスト ストリームに書き込みます。

Write(Int64)

8 バイト符号付き整数のテキスト表現をテキスト ストリームに書き込みます。

Write(Object)

そのオブジェクトの ToString メソッドを呼び出して、オブジェクトのテキスト表現をテキスト ストリームに書き込みます。

Write(ReadOnlySpan<Char>)

テキスト ストリームに文字スパンを書き込みます。

Write(Single)

4 バイト浮動小数点値のテキスト表現をテキスト ストリームに書き込みます。

Write(String)

文字列をテキスト ストリームに書き込みます。

Write(String, Object)

Format(String, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。

Write(String, Object, Object)

Format(String, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。

Write(String, Object, Object, Object)

Format(String, Object, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。

Write(String, Object[])

Format(String, Object[]) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。

Write(String, ReadOnlySpan<Object>)

Format(String, ReadOnlySpan<Object>)と同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。

Write(StringBuilder)

文字列ビルダーをテキスト ストリームに書き込みます。

Write(UInt32)

4 バイト符号なし整数のテキスト表現をテキスト ストリームに書き込みます。

Write(UInt64)

8 バイト符号なし整数のテキスト表現をテキスト ストリームに書き込みます。

WriteAsync(Char)

文字をテキスト ストリームに非同期的に書き込みます。

WriteAsync(Char[])

文字配列をテキスト ストリームに非同期的に書き込みます。

WriteAsync(Char[], Int32, Int32)

文字のサブ配列をテキスト ストリームに非同期的に書き込みます。

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

文字メモリ領域をテキスト ストリームに非同期的に書き込みます。

WriteAsync(String)

文字列をテキスト ストリームに非同期的に書き込みます。

WriteAsync(StringBuilder, CancellationToken)

文字列ビルダーをテキスト ストリームに非同期的に書き込みます。

WriteLine()

行終端記号をテキスト ストリームに書き込みます。

WriteLine(Boolean)

Boolean 値のテキスト表現をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。

WriteLine(Char)

テキスト ストリームに文字を書き込み、続けて行終端記号を書き込みます。

WriteLine(Char[])

文字の配列をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。

WriteLine(Char[], Int32, Int32)

テキスト ストリームに文字のサブ配列を書き込み、続けて行終端記号を書き込みます。

WriteLine(Decimal)

10 進値のテキスト表現をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。

WriteLine(Double)

8 バイト浮動小数点値のテキスト表現をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。

WriteLine(Int32)

4 バイト符号付き整数のテキスト表現をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。

WriteLine(Int64)

8 バイト符号付き整数のテキスト表現をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。

WriteLine(Object)

オブジェクトのテキスト表現をテキスト ストリームに書き込みます。そのオブジェクトで ToString メソッドを呼び出し、続けて行終端記号を呼び出します。

WriteLine(ReadOnlySpan<Char>)

文字範囲のテキスト表現をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。

WriteLine(Single)

4 バイト浮動小数点値のテキスト表現をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。

WriteLine(String)

文字列をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。

WriteLine(String, Object)

Format(String, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列と新しい行をテキスト ストリームに書き込みます。

WriteLine(String, Object, Object)

Format(String, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列と新しい行をテキスト ストリームに書き込みます。

WriteLine(String, Object, Object, Object)

Format(String, Object)と同じセマンティクスを使用して、書式設定された文字列と新しい行をテキスト ストリームに書き込みます。

WriteLine(String, Object[])

Format(String, Object)と同じセマンティクスを使用して、書式設定された文字列と新しい行をテキスト ストリームに書き込みます。

WriteLine(String, ReadOnlySpan<Object>)

Format(String, ReadOnlySpan<Object>)と同じセマンティクスを使用して、書式設定された文字列と新しい行をテキスト ストリームに書き込みます。

WriteLine(StringBuilder)

文字列ビルダーのテキスト表現をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。

WriteLine(UInt32)

4 バイト符号なし整数のテキスト表現をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。

WriteLine(UInt64)

8 バイト符号なし整数のテキスト表現をテキスト ストリームに書き込み、続けて行終端記号を書き込みます。

WriteLineAsync()

テキスト ストリームに行ターミネータを非同期に書き込みます。

WriteLineAsync(Char)

テキスト ストリームに文字を非同期に書き込み、続けて行終端記号を書き込みます。

WriteLineAsync(Char[])

テキスト ストリームに文字の配列を非同期に書き込み、続けて行終端記号を書き込みます。

WriteLineAsync(Char[], Int32, Int32)

テキスト ストリームに文字のサブ配列を非同期に書き込み、続けて行終端記号を書き込みます。

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

文字メモリ領域のテキスト表現をテキスト ストリームに非同期的に書き込み、続けて行終端記号を書き込みます。

WriteLineAsync(String)

テキスト ストリームに文字列を非同期に書き込み、続けて行終端記号を書き込みます。

WriteLineAsync(StringBuilder, CancellationToken)

文字列ビルダーのテキスト表現をテキスト ストリームに非同期的に書き込み、続けて行終端記号を書き込みます。

明示的なインターフェイスの実装

IDisposable.Dispose()

このメンバーの説明については、Dispose()を参照してください。

拡張メソッド

ConfigureAwait(IAsyncDisposable, Boolean)

非同期破棄から返されるタスクの待機を実行する方法を構成します。

適用対象

こちらもご覧ください