TextWriter クラス

リファレンス

定義

名前空間:: System.IO

アセンブリ:: System.IO.dll

アセンブリ:: System.Runtime.dll

アセンブリ:: System.Runtime.Extensions.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

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

継承: Object
TextWriter

継承: Object

MarshalByRefObject
TextWriter

派生: System.CodeDom.Compiler.IndentedTextWriter

System.IO.StreamWriter

System.IO.StringWriter

System.Web.HttpWriter

System.Web.UI.HtmlTextWriter

属性: SerializableAttribute ComVisibleAttribute

実装: IDisposable IAsyncDisposable

例

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は、および StringWriterのStreamWriter抽象基底クラスであり、それぞれストリームと文字列に文字を書き込みます。のインスタンス 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()	現在のライターを終了し、ライターに関連付けられたすべてのシステムリソースを解放します。
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)

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

適用対象