TextWriter クラス

リファレンス

定義

名前空間:: System.IO

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

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

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

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

ソース:: TextWriter.cs

ソース:: TextWriter.cs

ソース:: TextWriter.cs

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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 から派生し、ストリームに書き込むためのメンバーの実装を提供します。次の例では、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 は、ストリームと文字列にそれぞれ文字を書き込む StreamWriter と StringWriterの抽象基底クラスです。 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)

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

適用対象

次の方法で共有