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 派生し、ストリームに書き込むメンバーの実装を提供します。 次の例は、 メソッドを使用して文字列値で構成される 2 行をテキスト ファイルに書き込む方法を WriteLineAsync(String) 示しています。

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

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

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

重要

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

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。

注意 (実装者)

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

コンストラクター

TextWriter()

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

TextWriter(IFormatProvider)

指定した書式プロバイダーで TextWriter クラスの新しいインスタンスを初期化します。

フィールド

CoreNewLine

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

Null

バッキング ストアを持たない書き込み専用の TextWriter を提供します。

プロパティ

Encoding

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

FormatProvider

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

NewLine

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

メソッド

Close()

現在のライターを終了し、ライターに関連付けられたすべてのシステム リソースを解放します。

CreateBroadcasting(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(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(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)

非同期の破棄可能から返されるタスク上での待機がどのように実行されるかを構成します。

適用対象

こちらもご覧ください