DOBON.NET プログラミング道: .NET Framework, VB.NET, C#, Visual Basic, Visual Studio, インストーラ, ...

• 文字コードを指定してテキストファイルを読み込む
  • ストリームを使ってテキストファイルを読み込む
    • 文字コードの指定
    • 一行ずつ読み込む
    • 一文字ずつ読み込む
    • 指定した文字数ずつ読み込む
  • .NET Framework 2.0以降で、ストリームを使わずに簡単に読み込む
• この記事への評価、コメント、トラックバック

文字コードを指定してテキストファイルを読み込む

ここでは、テキストファイルの内容を文字列として読み込む方法について説明します。

ストリームを使ってテキストファイルを読み込む

最も基本的な方法は、StreamReaderクラスを使う方法です。

早速ですが、以下にStreamReaderクラスを用いてテキストファイルの内容を読み込む簡単な例を示します。この例ではテキストファイル"C:\test.txt"をReadToEndメソッドですべて読み込んでいます。

'"C:\test.txt"をShift-JISコードとして開く
Dim sr As New System.IO.StreamReader("C:\test.txt", _
    System.Text.Encoding.GetEncoding("shift_jis"))
'内容をすべて読み込む
Dim s As String =  sr.ReadToEnd() 
'閉じる
sr.Close()
 
'結果を出力する
Console.WriteLine(s)

//"C:\test.txt"をShift-JISコードとして開く
System.IO.StreamReader sr = new System.IO.StreamReader(
    @"C:\test.txt",
    System.Text.Encoding.GetEncoding("shift_jis"));
//内容をすべて読み込む
string s = sr.ReadToEnd();
//閉じる
sr.Close();

//結果を出力する
Console.WriteLine(s);

StreamReaderは使用後にCloseメソッドを使って閉じる必要があります。通常は、usingステートメントやtry...finallyを使って確実にCloseメソッドが呼び出されるようにします。詳しくは、「Dispose、Closeが確実に呼び出されるようにする」をご覧ください。

文字コードの指定

Encoding.GetEncodingメソッドについて説明します。Encoding.GetEncodingメソッドは指定されたエンコーディングのEncodingオブジェクトを返します。上記の例では、文字コードをShift JISとしてファイルを開いたことになります。

上記の例ではShift JISのEncodingを"shift_jis"というコードページ名で指定していますが、コードページIDである「932」で指定することも出来ます。

'"C:\test.txt"をShift-JISコードとして開く
Dim sr As New System.IO.StreamReader("C:\test.txt", _
    System.Text.Encoding.GetEncoding(932))

//"C:\test.txt"をShift-JISコードとして開く
System.IO.StreamReader sr = new System.IO.StreamReader(
    @"C:\test.txt",
    System.Text.Encoding.GetEncoding(932));

その他の文字コードを指定する場合も同様にコードページIDかコードページ名を指定します。主な文字コードのコードページIDとコードページ名を以下に示します。

これ以外の文字コードに関しては、「Encoding クラス」や「Code Page Identifiers」をご覧ください。

なおStreamReaderのコンストラクタでEncodingを指定しなかった時はUTF-8として読み込まれます。

• 関連：
• 文字コードを判別する

一行ずつ読み込む

先の例では1度にすべて読み込みましたが、今度は一行ずつ読み込む例を示します。ReadLineメソッドで一行読み込み、Peekメソッドで末尾を確認します。ReadLineメソッドはファイルを最後まで読み込むとnull（VB.NETではNothing）を返しますので、これで末尾を判断することもできます。

なおReadLineメソッドが返す文字列には末尾の改行記号（キャリッジリターン、ラインフィード）が含まれませんので注意してください。

'"C:\test.txt"をShift-JISコードとして開く
Dim sr As New System.IO.StreamReader("C:\test.txt", _
    System.Text.Encoding.GetEncoding("shift_jis"))
'内容を一行ずつ読み込む
While sr.Peek() > -1
    Console.WriteLine(sr.ReadLine())
End While
'閉じる
sr.Close()

//"C:\test.txt"をShift-JISコードとして開く
System.IO.StreamReader sr = new System.IO.StreamReader(
    @"C:\test.txt",
    System.Text.Encoding.GetEncoding("shift_jis"));
//内容を一行ずつ読み込む
while (sr.Peek() > -1)
{
    Console.WriteLine(sr.ReadLine());
}
//閉じる
sr.Close();

一文字ずつ読み込む

Readメソッドにより、一文字ずつ読み込むこともできます。Readメソッドは整数を返し、最後まで読み込むと-1を返します。この整数を文字に変換するには、Convert.ToCharメソッドなどを使用します。

'"C:\test.txt"をShift-JISコードとして開く
Dim sr As New System.IO.StreamReader( _
    "C:\test.txt", System.Text.Encoding.GetEncoding("shift_jis"))
'内容を一文字ずつ読み込む
While sr.Peek() > -1
    Console.Write(Convert.ToChar(sr.Read()))
End While
'閉じる
sr.Close()

//"C:\test.txt"をShift-JISコードとして開く
System.IO.StreamReader sr = new System.IO.StreamReader(
    @"C:\test.txt",
    System.Text.Encoding.GetEncoding("shift_jis"));
//内容を一文字ずつ読み込む
while (sr.Peek() > -1)
{
    Console.Write(Convert.ToChar(sr.Read()));
}
//閉じる
sr.Close();

指定した文字数ずつ読み込む

ReadBlockメソッドを使って、指定した文字数だけ読み込むこともできます。ReadBlockメソッドは読み込んだ文字数を返し、ファイルの末尾に達していると、0を返します。

10文字ずつ読み込む例を以下に示します。

'"C:\test.txt"をShift-JISコードとして開く
Dim sr As New System.IO.StreamReader( _
    "C:\test.txt", System.Text.Encoding.GetEncoding("shift_jis"))
'内容を10文字ずつ読み込む
While sr.Peek() > -1
    Dim c(9) As Char
    sr.ReadBlock(c, 0, c.Length)
    Console.Write(c)
End While
'閉じる
sr.Close()

//"C:\test.txt"をShift-JISコードとして開く
System.IO.StreamReader sr = new System.IO.StreamReader(
    @"C:\test.txt",
    System.Text.Encoding.GetEncoding("shift_jis"));
//内容を10文字ずつ読み込む
while (sr.Peek() > -1)
{
    char[] c = new char[10];
    sr.ReadBlock(c, 0, c.Length);
    Console.Write(c);
}
//閉じる
sr.Close();

.NET Framework 2.0以降で、ストリームを使わずに簡単に読み込む

.NET Framework 2.0からは、File.ReadAllTextメソッドやReadAllLinesメソッドにより、指定したファイルの中身を指定した文字コードですべて読み込むことができます。ReadAllTextはファイルの中身すべてをStringに読み込みます。ReadAllLinesも同じくすべてを読み込みますが、行で分割されたString配列に読み込みます。

これらのメソッドは例外が発生しても確実にファイルを閉じるため、安心です。テキストファイルからすべての文字列を読み込むだけならば、StreamReader.ReadToEndメソッドよりも圧倒的に便利です。

以下にReadAllTextとReadAllLinesメソッドを使った例を示します。

'読み込むテキストファイル
Dim textFile As String = "C:\text.txt"
'文字コード(ここでは、Shift JIS)
Dim enc As System.Text.Encoding = System.Text.Encoding.GetEncoding("shift_jis")

'テキストファイルの中身をすべて読み込む
Dim str As String = System.IO.File.ReadAllText(textFile, enc)

'行ごとの配列として、テキストファイルの中身をすべて読み込む
Dim lines As String() = System.IO.File.ReadAllLines(textFile, enc)

//読み込むテキストファイル
string textFile = "C:\\text.txt";
//文字コード(ここでは、Shift JIS)
System.Text.Encoding enc = System.Text.Encoding.GetEncoding("shift_jis");

//テキストファイルの中身をすべて読み込む
string str = System.IO.File.ReadAllText(textFile, enc);

//行ごとの配列として、テキストファイルの中身をすべて読み込む
string[] lines = System.IO.File.ReadAllLines(textFile, enc);

• 関連：
• 文字コードを指定してテキストファイルに書き込む
• ファイルをロック（アクセスを制限）する

• 履歴：
• 2006/11/20 「一文字ずつ読み込む」「指定した文字数ずつ読み込む」を追加など。
• 2007/1/25 File.ReadAllTextとReadAllLinesメソッドに関する記述を追加。
• 2010/1/22 説明やコードの一部をより分かりやすいように書き換える。
• 2010/9/9 Encodingに関する説明を補充。