StreamWriter クラス

リファレンス

定義

名前空間:: System.IO

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

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

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

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

ソース:: StreamWriter.cs

ソース:: StreamWriter.cs

ソース:: StreamWriter.cs

重要

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

特定のエンコードでストリームに文字を書き込むための TextWriter を実装します。

public ref class StreamWriter : System::IO::TextWriter

public class StreamWriter : System.IO.TextWriter

[System.Serializable]
public class StreamWriter : System.IO.TextWriter

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class StreamWriter : System.IO.TextWriter

type StreamWriter = class
    inherit TextWriter

[<System.Serializable>]
type StreamWriter = class
    inherit TextWriter

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StreamWriter = class
    inherit TextWriter

Public Class StreamWriter
Inherits TextWriter

継承: Object

TextWriter
StreamWriter

継承: Object

MarshalByRefObject

TextWriter
StreamWriter

属性: SerializableAttribute ComVisibleAttribute

例

次の例では、StreamWriter オブジェクトを使用して、C ドライブ上のディレクトリを一覧表示するファイルを書き込み、StreamReader オブジェクトを使用して各ディレクトリ名を読み取って表示する方法を示します。アンマネージリソースが正しく破棄されるように、using ステートメントでこれらのオブジェクトを使用することをお勧めします。 using ステートメントは、使用しているコードが完了したときに、オブジェクトの Dispose を自動的に呼び出します。この例で使用するコンストラクターは、Windows ストアアプリでの使用はサポートされていません。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.IO;

namespace StreamReadWrite
{
    class Program
    {
        static void Main(string[] args)
        {
            // Get the directories currently on the C drive.
            DirectoryInfo[] cDirs = new DirectoryInfo(@"c:\").GetDirectories();

            // Write each directory name to a file.
            using (StreamWriter sw = new StreamWriter("CDriveDirs.txt"))
            {
                foreach (DirectoryInfo dir in cDirs)
                {
                    sw.WriteLine(dir.Name);
                }
            }

            // Read and show each line from the file.
            string line = "";
            using (StreamReader sr = new StreamReader("CDriveDirs.txt"))
            {
                while ((line = sr.ReadLine()) != null)
                {
                    Console.WriteLine(line);
                }
            }
        }
    }
}

Imports System.IO
Class Program

    Shared Sub Main()

        ' Get the directories currently on the C drive.
        Dim cDirs As DirectoryInfo() = New DirectoryInfo("c:\").GetDirectories()

        ' Write each directory name to a file.
        Using sw As StreamWriter = New StreamWriter("CDriveDirs.txt")
            For Each Dir As DirectoryInfo In cDirs
                sw.WriteLine(Dir.Name)
            Next
        End Using

        'Read and show each line from the file.
        Dim line As String = ""
        Using sr As StreamReader = New StreamReader("CDriveDirs.txt")
            Do
                line = sr.ReadLine()
                Console.WriteLine(line)
            Loop Until line Is Nothing
        End Using


    End Sub

End Class

注釈

StreamWriter は特定のエンコーディングでの文字出力用に設計されていますが、Stream から派生したクラスはバイト入力と出力用に設計されています。

重要

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

StreamWriter は、特に指定しない限り、既定で UTF8Encoding のインスタンスを使用します。 UTF8Encoding のこのインスタンスはバイトオーダーマーク (BOM) なしで構築されるため、GetPreamble メソッドは空のバイト配列を返します。このコンストラクターの既定の UTF-8 エンコードでは、無効なバイトに対して例外がスローされます。この動作は、Encoding.UTF8 プロパティのエンコードオブジェクトによって提供される動作とは異なります。 BOM を指定し、無効なバイトで例外がスローされるかどうかを判断するには、StreamWriter(String, Boolean, Encoding) や StreamWriterなどのエンコードオブジェクトをパラメーターとして受け入れるコンストラクターを使用します。

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

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

コンストラクター

StreamWriter(Stream)	UTF-8 エンコードと既定のバッファーサイズを使用して、指定したストリームの StreamWriter クラスの新しいインスタンスを初期化します。
StreamWriter(Stream, Encoding)	指定したエンコードと既定のバッファーサイズを使用して、指定したストリームの StreamWriter クラスの新しいインスタンスを初期化します。
StreamWriter(Stream, Encoding, Int32)	指定したエンコードとバッファーサイズを使用して、指定したストリームの StreamWriter クラスの新しいインスタンスを初期化します。
StreamWriter(Stream, Encoding, Int32, Boolean)	指定したエンコードとバッファーサイズを使用して、指定したストリームの StreamWriter クラスの新しいインスタンスを初期化し、必要に応じてストリームを開いたままにします。
StreamWriter(String)	既定のエンコードとバッファーサイズを使用して、指定したファイルの StreamWriter クラスの新しいインスタンスを初期化します。
StreamWriter(String, Boolean)	既定のエンコードとバッファーサイズを使用して、指定したファイルの StreamWriter クラスの新しいインスタンスを初期化します。ファイルが存在する場合は、上書きまたは追加することができます。ファイルが存在しない場合、このコンストラクターは新しいファイルを作成します。
StreamWriter(String, Boolean, Encoding)	指定したエンコードと既定のバッファーサイズを使用して、指定したファイルの StreamWriter クラスの新しいインスタンスを初期化します。ファイルが存在する場合は、上書きまたは追加することができます。ファイルが存在しない場合、このコンストラクターは新しいファイルを作成します。
StreamWriter(String, Boolean, Encoding, Int32)	指定したエンコードとバッファーサイズを使用して、指定したパス上の指定したファイルの StreamWriter クラスの新しいインスタンスを初期化します。ファイルが存在する場合は、上書きまたは追加することができます。ファイルが存在しない場合、このコンストラクターは新しいファイルを作成します。
StreamWriter(String, Encoding, FileStreamOptions)	指定したエンコードを使用し、指定した FileStreamOptions オブジェクトで構成された、指定したファイルの StreamWriter クラスの新しいインスタンスを初期化します。
StreamWriter(String, FileStreamOptions)	既定のエンコードを使用して、指定したファイルの StreamWriter クラスの新しいインスタンスを初期化し、指定した FileStreamOptions オブジェクトで構成します。

フィールド

CoreNewLine	この `TextWriter`に使用される改行文字を格納します。 (継承元 TextWriter)
Null	書き込み可能で読み取りはできないバッキングストアのない `StreamWriter` を提供します。

プロパティ

AutoFlush	Write(Char)を呼び出すたびに、StreamWriter が基になるストリームにバッファーをフラッシュするかどうかを示す値を取得または設定します。
BaseStream	バッキングストアとインターフェイスする基になるストリームを取得します。
Encoding	出力が書き込まれる Encoding を取得します。
FormatProvider	書式設定を制御するオブジェクトを取得します。 (継承元 TextWriter)
NewLine	現在の `TextWriter`で使用される行ターミネータ文字列を取得または設定します。 (継承元 TextWriter)

メソッド

Close()	現在の `StreamWriter` オブジェクトと基になるストリームを閉じます。
Close()	現在のライターを閉じ、ライターに関連付けられているシステムリソースを解放します。 (継承元 TextWriter)
CreateObjRef(Type)	リモートオブジェクトとの通信に使用されるプロキシの生成に必要なすべての関連情報を含むオブジェクトを作成します。 (継承元 MarshalByRefObject)
Dispose()	TextWriter オブジェクトによって使用されるすべてのリソースを解放します。 (継承元 TextWriter)
Dispose(Boolean)	バッファー内のデータを基になるストリームに書き込み、StreamWriterによって使用されるアンマネージリソース、および必要に応じてマネージドリソースを解放します。
DisposeAsync()	バッファー内のデータを基になるストリームに非同期的に書き込み、StreamWriterによって使用されるアンマネージリソースを解放します。
DisposeAsync()	TextWriter オブジェクトによって使用されるすべてのリソースを非同期的に解放します。 (継承元 TextWriter)
Equals(Object)	指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
Finalize()	ガベージコレクターによって再利用される前に、現在の StreamWriter のリソースを解放します。
Flush()	現在のライターのすべてのバッファーをクリアし、バッファー内のデータを基になるストリームに書き込みます。
FlushAsync()	このストリームのすべてのバッファーを非同期的にクリアし、バッファー内のデータを基になるデバイスに書き込みます。
FlushAsync()	現在のライターのすべてのバッファーを非同期的にクリアし、バッファー内のデータを基になるデバイスに書き込みます。 (継承元 TextWriter)
FlushAsync(CancellationToken)	このストリームのすべてのバッファーを非同期的にクリアし、バッファー内のデータを基になるデバイスに書き込みます。
FlushAsync(CancellationToken)	現在のライターのすべてのバッファーを非同期的にクリアし、バッファー内のデータを基になるデバイスに書き込みます。 (継承元 TextWriter)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetLifetimeService()	古い. このインスタンスの有効期間ポリシーを制御する現在の有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
InitializeLifetimeService()	古い. このインスタンスの有効期間ポリシーを制御する有効期間サービスオブジェクトを取得します。 (継承元 MarshalByRefObject)
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
MemberwiseClone(Boolean)	現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
Write(Boolean)	`Boolean` 値のテキスト表現をテキストストリームに書き込みます。 (継承元 TextWriter)
Write(Char)	ストリームに文字を書き込みます。
Write(Char[])	ストリームに文字配列を書き込みます。
Write(Char[], Int32, Int32)	ストリームに文字のサブ配列を書き込みます。
Write(Decimal)	10 進値のテキスト表現をテキストストリームに書き込みます。 (継承元 TextWriter)
Write(Double)	8 バイト浮動小数点値のテキスト表現をテキストストリームに書き込みます。 (継承元 TextWriter)
Write(Int32)	4 バイト符号付き整数のテキスト表現をテキストストリームに書き込みます。 (継承元 TextWriter)
Write(Int64)	8 バイト符号付き整数のテキスト表現をテキストストリームに書き込みます。 (継承元 TextWriter)
Write(Object)	そのオブジェクトの `ToString` メソッドを呼び出して、オブジェクトのテキスト表現をテキストストリームに書き込みます。 (継承元 TextWriter)
Write(ReadOnlySpan<Char>)	ストリームに文字スパンを書き込みます。
Write(ReadOnlySpan<Char>)	テキストストリームに文字スパンを書き込みます。 (継承元 TextWriter)
Write(Single)	4 バイト浮動小数点値のテキスト表現をテキストストリームに書き込みます。 (継承元 TextWriter)
Write(String)	ストリームに文字列を書き込みます。
Write(String, Object)	Format(String, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をストリームに書き込みます。
Write(String, Object)	Format(String, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキストストリームに書き込みます。 (継承元 TextWriter)
Write(String, Object, Object)	Format(String, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をストリームに書き込みます。
Write(String, Object, Object)	Format(String, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキストストリームに書き込みます。 (継承元 TextWriter)
Write(String, Object, Object, Object)	Format(String, Object, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をストリームに書き込みます。
Write(String, Object, Object, Object)	Format(String, Object, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキストストリームに書き込みます。 (継承元 TextWriter)
Write(String, Object[])	Format(String, Object[]) メソッドと同じセマンティクスを使用して、書式設定された文字列をストリームに書き込みます。
Write(String, Object[])	Format(String, Object[]) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキストストリームに書き込みます。 (継承元 TextWriter)
Write(String, ReadOnlySpan<Object>)	Format(String, ReadOnlySpan<Object>)と同じセマンティクスを使用して、書式設定された文字列をストリームに書き込みます。
Write(String, ReadOnlySpan<Object>)	Format(String, ReadOnlySpan<Object>)と同じセマンティクスを使用して、書式設定された文字列をテキストストリームに書き込みます。 (継承元 TextWriter)
Write(StringBuilder)	文字列ビルダーをテキストストリームに書き込みます。 (継承元 TextWriter)
Write(UInt32)	4 バイト符号なし整数のテキスト表現をテキストストリームに書き込みます。 (継承元 TextWriter)
Write(UInt64)	8 バイト符号なし整数のテキスト表現をテキストストリームに書き込みます。 (継承元 TextWriter)
WriteAsync(Char)	ストリームに文字を非同期に書き込みます。
WriteAsync(Char)	文字をテキストストリームに非同期的に書き込みます。 (継承元 TextWriter)
WriteAsync(Char[])	文字配列をテキストストリームに非同期的に書き込みます。 (継承元 TextWriter)
WriteAsync(Char[], Int32, Int32)	文字のサブ配列をストリームに非同期的に書き込みます。
WriteAsync(Char[], Int32, Int32)	文字のサブ配列をテキストストリームに非同期的に書き込みます。 (継承元 TextWriter)
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	文字メモリ領域をストリームに非同期的に書き込みます。
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	文字メモリ領域をテキストストリームに非同期的に書き込みます。 (継承元 TextWriter)
WriteAsync(String)	ストリームに文字列を非同期に書き込みます。
WriteAsync(String)	文字列をテキストストリームに非同期的に書き込みます。 (継承元 TextWriter)
WriteAsync(StringBuilder, CancellationToken)	文字列ビルダーをテキストストリームに非同期的に書き込みます。 (継承元 TextWriter)
WriteLine()	行終端記号をテキストストリームに書き込みます。 (継承元 TextWriter)
WriteLine(Boolean)	`Boolean` 値のテキスト表現をテキストストリームに書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter)
WriteLine(Char)	テキストストリームに文字を書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter)
WriteLine(Char[])	文字の配列をテキストストリームに書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter)
WriteLine(Char[], Int32, Int32)	テキストストリームに文字のサブ配列を書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter)
WriteLine(Decimal)	10 進値のテキスト表現をテキストストリームに書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter)
WriteLine(Double)	8 バイト浮動小数点値のテキスト表現をテキストストリームに書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter)
WriteLine(Int32)	4 バイト符号付き整数のテキスト表現をテキストストリームに書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter)
WriteLine(Int64)	8 バイト符号付き整数のテキスト表現をテキストストリームに書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter)
WriteLine(Object)	オブジェクトのテキスト表現をテキストストリームに書き込みます。そのオブジェクトで `ToString` メソッドを呼び出し、続けて行終端記号を呼び出します。 (継承元 TextWriter)
WriteLine(ReadOnlySpan<Char>)	文字スパンのテキスト表現をストリームに書き込み、続けて行終端記号を書き込みます。
WriteLine(ReadOnlySpan<Char>)	文字範囲のテキスト表現をテキストストリームに書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter)
WriteLine(Single)	4 バイト浮動小数点値のテキスト表現をテキストストリームに書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter)
WriteLine(String)	ストリームに文字列を書き込み、続けて行終端記号を書き込みます。
WriteLine(String)	文字列をテキストストリームに書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter)
WriteLine(String, Object)	Format(String, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列と新しい行をストリームに書き込みます。
WriteLine(String, Object)	Format(String, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列と新しい行をテキストストリームに書き込みます。 (継承元 TextWriter)
WriteLine(String, Object, Object)	Format(String, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列と新しい行をストリームに書き込みます。
WriteLine(String, Object, Object)	Format(String, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列と新しい行をテキストストリームに書き込みます。 (継承元 TextWriter)
WriteLine(String, Object, Object, Object)	Format(String, Object)と同じセマンティクスを使用して、書式設定された文字列と新しい行をストリームに書き込みます。
WriteLine(String, Object, Object, Object)	Format(String, Object)と同じセマンティクスを使用して、書式設定された文字列と新しい行をテキストストリームに書き込みます。 (継承元 TextWriter)
WriteLine(String, Object[])	Format(String, Object)と同じセマンティクスを使用して、書式設定された文字列と新しい行をストリームに書き込みます。
WriteLine(String, Object[])	Format(String, Object)と同じセマンティクスを使用して、書式設定された文字列と新しい行をテキストストリームに書き込みます。 (継承元 TextWriter)
WriteLine(String, ReadOnlySpan<Object>)	Format(String, ReadOnlySpan<Object>)と同じセマンティクスを使用して、書式設定された文字列と新しい行をストリームに書き込みます。
WriteLine(String, ReadOnlySpan<Object>)	Format(String, ReadOnlySpan<Object>)と同じセマンティクスを使用して、書式設定された文字列と新しい行をテキストストリームに書き込みます。 (継承元 TextWriter)
WriteLine(StringBuilder)	文字列ビルダーのテキスト表現をテキストストリームに書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter)
WriteLine(UInt32)	4 バイト符号なし整数のテキスト表現をテキストストリームに書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter)
WriteLine(UInt64)	8 バイト符号なし整数のテキスト表現をテキストストリームに書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter)
WriteLineAsync()	行ターミネータをストリームに非同期的に書き込みます。
WriteLineAsync()	テキストストリームに行ターミネータを非同期に書き込みます。 (継承元 TextWriter)
WriteLineAsync(Char)	ストリームに文字を非同期に書き込み、続けて行ターミネータを書き込みます。
WriteLineAsync(Char)	テキストストリームに文字を非同期に書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter)
WriteLineAsync(Char[])	テキストストリームに文字の配列を非同期に書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter)
WriteLineAsync(Char[], Int32, Int32)	ストリームに文字のサブ配列を非同期に書き込み、続けて行終端記号を書き込みます。
WriteLineAsync(Char[], Int32, Int32)	テキストストリームに文字のサブ配列を非同期に書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter)
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	文字メモリ領域のテキスト表現をストリームに非同期的に書き込み、続けて行終端記号を書き込みます。
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	文字メモリ領域のテキスト表現をテキストストリームに非同期的に書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter)
WriteLineAsync(String)	ストリームに文字列を非同期に書き込み、続けて行ターミネータを書き込みます。
WriteLineAsync(String)	テキストストリームに文字列を非同期に書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter)
WriteLineAsync(StringBuilder, CancellationToken)	文字列ビルダーのテキスト表現をテキストストリームに非同期的に書き込み、続けて行終端記号を書き込みます。 (継承元 TextWriter)

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

IDisposable.Dispose()

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

(継承元 TextWriter)

拡張メソッド

ConfigureAwait(IAsyncDisposable, Boolean)

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

適用対象

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

AI Skills Fest

次の方法で共有