StreamWriter クラス

StreamWriter は、文字を特定のエンコーディングで出力するために使用します。一方、Stream の派生クラスは、バイトの入出力に使用します。

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

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

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

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

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);
                }
            }
        }
    }
}

.NET Framework

.NET Framework Client Profile

汎用性のあるクラス ライブラリ

Windows ストア アプリ用 .NET

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (サーバー コア ロールはサポート対象外), Windows Server 2008 R2 (SP1 以降でサーバー コア ロールをサポート。Itanium はサポート対象外)

関連項目

その他の技術情報