TextWriter TextWriter TextWriter TextWriter Class

定義

一連の文字を書き込むことができるライターを表します。Represents a writer that can write a sequential series of characters. このクラスは抽象クラスです。This class is abstract.

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

TextWriter クラスは抽象クラスです。The TextWriter class is an abstract class. そのため、コードでそれをインスタンス化することはありません。Therefore, you do not instantiate it in your code. クラスStreamWriterはからTextWriter派生し、ストリームへの書き込みのためのメンバーの実装を提供します。The StreamWriter class derives from TextWriter and provides implementations of the members for writing to a stream. 次の例は、 WriteLineAsync(String)メソッドを使用して、文字列値で構成される2つの行をテキストファイルに書き込む方法を示しています。The following example shows how to write two lines that consist of string values to a text file by using the WriteLineAsync(String) method.

派生クラスで Dispose をオーバーライドしてを指定するOverride Dispose in a derived class to provide

using System;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            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 is the abstract base class of StreamWriter and StringWriter, which write characters to streams and strings, respectively. TextWriterインスタンスを作成して、オブジェクトを文字列に書き込む、ファイルに文字列を書き込む、または XML をシリアル化します。Create an instance of TextWriter to write an object to a string, write strings to a file, or to serialize XML. また、のインスタンスを使用しTextWriterて、文字列またはストリームに使用するのと同じ api を使用してカスタムバッキングストアにテキストを書き込んだり、テキストの書式設定のサポートを追加したりすることもできます。You can also use an instance of TextWriter to write text to a custom backing store using the same APIs you would use for a string or a stream, or to add support for text formatting.

プリミティブデータWrite型をTextWriterパラメーターとして持つすべてのメソッドは、値を文字列として書き込みます。All the Write methods of TextWriter having primitive data types as parameters write out the values as strings.

既定では、 TextWriterはスレッドセーフではありません。By default, a TextWriter is not thread safe. スレッドTextWriter.Synchronizedセーフなラッパーについては、「」を参照してください。See TextWriter.Synchronized for a thread-safe wrapper.

重要

この型は IDisposable インターフェイスを実装します。This type implements the IDisposable interface. この型から派生した任意の型の使用が完了したら、直接または間接的に破棄する必要があります。When you have finished using any type that derives from this type, you should dispose of it either directly or indirectly. 直接的に型を破棄するには、try / catch ブロック内で Dispose メソッドを呼び出します。To dispose of the type directly, call its Dispose method in a try/catch block. 間接的に型を破棄するには、using (C# の場合) または Using (Visual Basic 言語) などの言語構成要素を使用します。To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). 詳細については、「Dispose」および「 IDisposableインターフェイス」の「IDisposable を実装するオブジェクトの使用」を参照してください。For more information, see Dispose and the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

注意 (継承者)

Write(Char)TextWriter便利なインスタンスを作成するには、派生クラスでメソッドを最小限実装する必要があります。A derived class must minimally implement the Write(Char) method to make a useful instance of TextWriter.

コンストラクター

TextWriter() TextWriter() TextWriter() TextWriter()

TextWriter クラスの新しいインスタンスを初期化します。Initializes a new instance of the TextWriter class.

TextWriter(IFormatProvider) TextWriter(IFormatProvider) TextWriter(IFormatProvider) TextWriter(IFormatProvider)

指定した書式プロバイダーで TextWriter クラスの新しいインスタンスを初期化します。Initializes a new instance of the TextWriter class with the specified format provider.

フィールド

CoreNewLine CoreNewLine CoreNewLine CoreNewLine

この TextWriter で使用する改行文字を格納します。Stores the newline characters used for this TextWriter.

Null Null Null Null

バッキング ストアを持たない書き込み専用の TextWriter を提供します。Provides a TextWriter with no backing store that can be written to, but not read from.

プロパティ

Encoding Encoding Encoding Encoding

派生クラスによってオーバーライドされると、出力を書き込む文字エンコーディングを返します。When overridden in a derived class, returns the character encoding in which the output is written.

FormatProvider FormatProvider FormatProvider FormatProvider

書式を制御するオブジェクトを取得します。Gets an object that controls formatting.

NewLine NewLine NewLine NewLine

現在の TextWriter で使用される行終端文字列を取得または設定します。Gets or sets the line terminator string used by the current TextWriter.

メソッド

Close() Close() Close() Close()

現在のライターを終了し、ライターに関連付けられたすべてのシステム リソースを解放します。Closes the current writer and releases any system resources associated with the writer.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

この TextWriter オブジェクトによって使用されているすべてのリソースを解放します。Releases all resources used by the TextWriter object.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

TextWriter によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。Releases the unmanaged resources used by the TextWriter and optionally releases the managed resources.

DisposeAsync() DisposeAsync() DisposeAsync() DisposeAsync()

TextWriter オブジェクトによって使用されるすべてのリソースを非同期でリリースします。Asynchronously releases all resources used by the TextWriter object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
Flush() Flush() Flush() Flush()

現在のライターのすべてのバッファーをクリアし、バッファー内のデータを基になるデバイスに書き込みます。Clears all buffers for the current writer and causes any buffered data to be written to the underlying device.

FlushAsync() FlushAsync() FlushAsync() FlushAsync()

現在のライターのすべてのバッファーを非同期にクリアし、バッファー内のデータを基になるデバイスに書き込みます。Asynchronously clears all buffers for the current writer and causes any buffered data to be written to the underlying device.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Synchronized(TextWriter) Synchronized(TextWriter) Synchronized(TextWriter) Synchronized(TextWriter)

指定した TextWriter をラップするスレッド セーフ ラッパーを作成します。Creates a thread-safe wrapper around the specified TextWriter.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)
Write(Boolean) Write(Boolean) Write(Boolean) Write(Boolean)

Boolean 値のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of a Boolean value to the text stream.

Write(Char) Write(Char) Write(Char) Write(Char)

文字をテキスト ストリームに書き込みます。Writes a character to the text stream.

Write(Char[]) Write(Char[]) Write(Char[]) Write(Char[])

文字配列をテキスト ストリームに書き込みます。Writes a character array to the text stream.

Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32)

文字の部分配列をテキスト ストリームに書き込みます。Writes a subarray of characters to the text stream.

Write(Decimal) Write(Decimal) Write(Decimal) Write(Decimal)

10 進値のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of a decimal value to the text stream.

Write(Double) Write(Double) Write(Double) Write(Double)

8 バイト浮動小数点値のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of an 8-byte floating-point value to the text stream.

Write(Int32) Write(Int32) Write(Int32) Write(Int32)

4 バイト符号付き整数のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of a 4-byte signed integer to the text stream.

Write(Int64) Write(Int64) Write(Int64) Write(Int64)

8 バイト符号付き整数のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of an 8-byte signed integer to the text stream.

Write(Object) Write(Object) Write(Object) Write(Object)

オブジェクトで ToString メソッドを呼び出して、そのオブジェクトのテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of an object to the text stream by calling the ToString method on that object.

Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>)

文字スパンをテキスト ストリームに書き込みます。Writes a character span to the text stream.

Write(Single) Write(Single) Write(Single) Write(Single)

4 バイト浮動小数点値のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of a 4-byte floating-point value to the text stream.

Write(String) Write(String) Write(String) Write(String)

文字列をテキスト ストリームに書き込みます。Writes a string to the text stream.

Write(String, Object) Write(String, Object) Write(String, Object) Write(String, Object)

Format(String, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。Writes a formatted string to the text stream, using the same semantics as the Format(String, Object) method.

Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object)

Format(String, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。Writes a formatted string to the text stream using the same semantics as the Format(String, Object, Object) method.

Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(String, Object, Object, Object)

Format(String, Object, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。Writes a formatted string to the text stream, using the same semantics as the Format(String, Object, Object, Object) method.

Write(String, Object[]) Write(String, Object[]) Write(String, Object[]) Write(String, Object[])

Format(String, Object[]) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。Writes a formatted string to the text stream, using the same semantics as the Format(String, Object[]) method.

Write(StringBuilder) Write(StringBuilder) Write(StringBuilder) Write(StringBuilder)

文字列ビルダーをテキスト ストリームに書き込みます。Writes a string builder to the text stream.

Write(UInt32) Write(UInt32) Write(UInt32) Write(UInt32)

4 バイト符号なし整数のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of a 4-byte unsigned integer to the text stream.

Write(UInt64) Write(UInt64) Write(UInt64) Write(UInt64)

8 バイト符号なし整数のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of an 8-byte unsigned integer to the text stream.

WriteAsync(Char) WriteAsync(Char) WriteAsync(Char) WriteAsync(Char)

文字をテキスト ストリームに非同期で書き込みます。Writes a character to the text stream asynchronously.

WriteAsync(Char[]) WriteAsync(Char[]) WriteAsync(Char[]) WriteAsync(Char[])

文字配列をテキスト ストリームに非同期で書き込みます。Writes a character array to the text stream asynchronously.

WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32)

文字の部分配列をテキスト ストリームに非同期で書き込みます。Writes a subarray of characters to the text stream asynchronously.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken) WriteAsync(ReadOnlyMemory<Char>, CancellationToken) WriteAsync(ReadOnlyMemory<Char>, CancellationToken) WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

文字メモリ領域をテキスト ストリームに非同期で書き込みます。Asynchronously writes a character memory region to the text stream.

WriteAsync(String) WriteAsync(String) WriteAsync(String) WriteAsync(String)

文字列をテキスト ストリームに非同期で書き込みます。Writes a string to the text stream asynchronously.

WriteAsync(StringBuilder, CancellationToken) WriteAsync(StringBuilder, CancellationToken) WriteAsync(StringBuilder, CancellationToken) WriteAsync(StringBuilder, CancellationToken)

文字列ビルダーをテキスト ストリームに非同期で書き込みます。Asynchronously writes a string builder to the text stream.

WriteLine() WriteLine() WriteLine() WriteLine()

行終端記号をテキスト ストリームに書き込みます。Writes a line terminator to the text stream.

WriteLine(Boolean) WriteLine(Boolean) WriteLine(Boolean) WriteLine(Boolean)

Boolean 値のテキスト表現を、続いて行終端記号をテキスト ストリームに書き込みます。Writes the text representation of a Boolean value to the text stream, followed by a line terminator.

WriteLine(Char) WriteLine(Char) WriteLine(Char) WriteLine(Char)

文字を、続いて行終端記号をテキスト ストリームに書き込みます。Writes a character to the text stream, followed by a line terminator.

WriteLine(Char[]) WriteLine(Char[]) WriteLine(Char[]) WriteLine(Char[])

文字配列を、続いて行終端記号をテキスト ストリームに書き込みます。Writes an array of characters to the text stream, followed by a line terminator.

WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32)

文字の部分配列を、続いて行終端記号をテキスト ストリームに書き込みます。Writes a subarray of characters to the text stream, followed by a line terminator.

WriteLine(Decimal) WriteLine(Decimal) WriteLine(Decimal) WriteLine(Decimal)

10 進値のテキスト表現を、続いて行終端記号をテキスト ストリームに書き込みます。Writes the text representation of a decimal value to the text stream, followed by a line terminator.

WriteLine(Double) WriteLine(Double) WriteLine(Double) WriteLine(Double)

8 バイト浮動小数点値のテキスト表現を、続いて行終端記号をテキスト ストリームに書き込みます。Writes the text representation of a 8-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(Int32) WriteLine(Int32) WriteLine(Int32) WriteLine(Int32)

4 バイト符号付き整数のテキスト表現を、続いて行終端記号をテキスト ストリームに書き込みます。Writes the text representation of a 4-byte signed integer to the text stream, followed by a line terminator.

WriteLine(Int64) WriteLine(Int64) WriteLine(Int64) WriteLine(Int64)

8 バイト符号付き整数のテキスト表現を、続いて行終端記号をテキスト ストリームに書き込みます。Writes the text representation of an 8-byte signed integer to the text stream, followed by a line terminator.

WriteLine(Object) WriteLine(Object) WriteLine(Object) WriteLine(Object)

オブジェクトで ToString メソッドを呼び出して、そのオブジェクトのテキスト表現を、続いて行終端記号をテキスト ストリームに書き込みます。Writes the text representation of an object to the text stream, by calling the ToString method on that object, followed by a line terminator.

WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>)

文字スパンのテキスト表現を、続いて行終端記号をテキスト ストリームに書き込みます。Writes the text representation of a character span to the text stream, followed by a line terminator.

WriteLine(Single) WriteLine(Single) WriteLine(Single) WriteLine(Single)

4 バイト浮動小数点値のテキスト表現を、続いて行終端記号をテキスト ストリームに書き込みます。Writes the text representation of a 4-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(String) WriteLine(String) WriteLine(String) WriteLine(String)

文字列を、続いて行終端記号をテキスト ストリームに書き込みます。Writes a string to the text stream, followed by a line terminator.

WriteLine(String, Object) WriteLine(String, Object) WriteLine(String, Object) WriteLine(String, Object)

Format(String, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列と新しい行をテキスト ストリームに書き込みます。Writes a formatted string and a new line to the text stream, using the same semantics as the Format(String, Object) method.

WriteLine(String, Object, Object) WriteLine(String, Object, Object) WriteLine(String, Object, Object) WriteLine(String, Object, Object)

Format(String, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列と新しい行をテキスト ストリームに書き込みます。Writes a formatted string and a new line to the text stream, using the same semantics as the Format(String, Object, Object) method.

WriteLine(String, Object, Object, Object) WriteLine(String, Object, Object, Object) WriteLine(String, Object, Object, Object) WriteLine(String, Object, Object, Object)

Format(String, Object) と同じセマンティクスを使用して、書式設定された文字列と新しい行をテキスト ストリームに書き込みます。Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

WriteLine(String, Object[]) WriteLine(String, Object[]) WriteLine(String, Object[]) WriteLine(String, Object[])

Format(String, Object) と同じセマンティクスを使用して、書式設定された文字列と新しい行をテキスト ストリームに書き込みます。Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

WriteLine(StringBuilder) WriteLine(StringBuilder) WriteLine(StringBuilder) WriteLine(StringBuilder)

文字列ビルダーのテキスト表現を、続いて行終端記号をテキスト ストリームに書き込みます。Writes the text representation of a string builder to the text stream, followed by a line terminator.

WriteLine(UInt32) WriteLine(UInt32) WriteLine(UInt32) WriteLine(UInt32)

4 バイト符号なし整数のテキスト表現を、続いて行終端記号をテキスト ストリームに書き込みます。Writes the text representation of a 4-byte unsigned integer to the text stream, followed by a line terminator.

WriteLine(UInt64) WriteLine(UInt64) WriteLine(UInt64) WriteLine(UInt64)

8 バイト符号なし整数のテキスト表現を、続いて行終端記号をテキスト ストリームに書き込みます。Writes the text representation of an 8-byte unsigned integer to the text stream, followed by a line terminator.

WriteLineAsync() WriteLineAsync() WriteLineAsync() WriteLineAsync()

行終端記号をテキスト ストリームに非同期で書き込みます。Asynchronously writes a line terminator to the text stream.

WriteLineAsync(Char) WriteLineAsync(Char) WriteLineAsync(Char) WriteLineAsync(Char)

文字を、続いて行終端記号をテキスト ストリームに非同期で書き込みます。Asynchronously writes a character to the text stream, followed by a line terminator.

WriteLineAsync(Char[]) WriteLineAsync(Char[]) WriteLineAsync(Char[]) WriteLineAsync(Char[])

文字配列を、続いて行終端記号をテキスト ストリームに非同期で書き込みます。Asynchronously writes an array of characters to the text stream, followed by a line terminator.

WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32)

文字の部分配列を、続いて行終端記号をテキスト ストリームに非同期で書き込みます。Asynchronously writes a subarray of characters to the text stream, followed by a line terminator.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

文字メモリ領域のテキスト表現を、続いて行終端記号をテキスト ストリームに非同期で書き込みます。Asynchronously writes the text representation of a character memory region to the text stream, followed by a line terminator.

WriteLineAsync(String) WriteLineAsync(String) WriteLineAsync(String) WriteLineAsync(String)

文字列を、続いて行終端記号をテキスト ストリームに非同期で書き込みます。Asynchronously writes a string to the text stream, followed by a line terminator.

WriteLineAsync(StringBuilder, CancellationToken) WriteLineAsync(StringBuilder, CancellationToken) WriteLineAsync(StringBuilder, CancellationToken) WriteLineAsync(StringBuilder, CancellationToken)

文字列ビルダーのテキスト表現を、続いて行終端記号をテキスト ストリームに非同期で書き込みます。Asynchronously writes the text representation of a string builder to the text stream, followed by a line terminator.

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

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

このメンバーの説明については、Dispose() のトピックを参照してください。For a description of this member, see Dispose().

適用対象

こちらもご覧ください