C Sharpの基礎 - ファイル
バイナリファイル
バイナリファイルの読み込みと書き込み
ファイルの内容をすべてbyte配列に読み込む、または、byte配列全体をファイルに書き込む場合、
Fileクラス(System.IO名前空間)のReadAllBytesメソッドおよびWriteAllBytesメソッドを使用する。
これらのメソッド(静的)では、"ファイルを開く"、"byte配列への読み込みまたはbyte配列の書き込み"、"ファイルを閉じる"という3つの処理を
ReadAllBytesメソッドで実行可能である。
ReadAllBytesメソッドは、読み込むファイルのパス名をパラメータに指定して呼ぶと、戻り値としてファイルの内容を読み込んだbyte配列を返す。
また、WriteAllBytesメソッドでは、書き込むファイルのパス名(ファイルが存在する場合は上書き)と書き込むbyte配列をパラメータで指定する。
なお、WriteAllBytesメソッドの戻り値は無い。
byte[] data = File.ReadAllBytes(@"hoge.bin"); // 読み込み
File.WriteAllBytes(@"newhoge.bin", data); // 書き込み
バイナリファイルを固定サイズで分割する
以下の例では、FileクラスのReadAllBytesメソッドとWriteAllBytesメソッドを使用している。
バイナリファイルを読み込み、それを固定サイズ(1[MB])の複数ファイルに分割して出力している。
なお、出力する最後のファイルは固定サイズに満たない場合がある。
using System;
using System.IO;
class BinarySplit
{
static void Main()
{
// バイナリファイルの読み込み
byte[] src = File.ReadAllBytes(@"hoge.bin");
int FILESIZE = 1024 * 1024; // 分割サイズ
int num = 0;
for (int remain = src.Length; remain > 0; remain -= FILESIZE)
{
int length = Math.Min(FILESIZE, remain); // 作成する分割ファイルの実際のサイズ
byte[] dest = new byte[length]; // 分割ファイルへ書き出すbyte配列の作成
Array.Copy(src, num * FILESIZE, dest, 0, length);
// 出力ファイル名（out0001.bin、out0002.bin、……）
string name = String.Format("out{0:D4}.bin", num + 1);
// byte配列のファイルへの書き込み
File.WriteAllBytes(name, dest);
num++;
}
}
}
※注意
ReadAllBytesメソッドは、ファイル全体を一度に読み込むため、
サイズの大きいファイルを扱う場合は、読み込みに掛かる時間や使用するメモリ量について注意が必要である。
非同期でバイナリファイルを読み書きする
以下の例では、バイナリファイルへ書き込んだ後、そのバイナリファイルを読み込んでいる。
バイナリファイルを書き込み用として開く時にFileMode.Createを指定しているため、上書きになる。(追記する場合は、FileMode.Append)
public async Task BinaryReadWriteAsync(byte[] data)
{
const string FilePath = @".\sample.dat"; // 読み書きするファイル
// バイナリファイルとして書き込む
// ファイルを上書きモードで開く(ファイルが存在しない場合は作成する)
// 追記モードにするには、FileMode.Appendに変更する
using (var fs = new FileStream(FilePath, FileMode.Create, FileAccess.Write))
{
await fs.WriteAsync(data, 0, data.Length); // バイナリデータを非同期で書き込む
}
// バイナリファイル読み込み
byte[] result; // データを格納する配列
// ファイルを読み取りモードで開く
using (var fs = new FileStream(FilePath, FileMode.Open, FileAccess.Read))
{
result = new byte[fs.Length]; // データ格納用の配列を確保する
// バイナリデータを非同期で読み込む
await fs.ReadAsync(result, 0, (int)fs.Length);
}
// 読み込んだ内容をコンソールへ出力する
for (int i=0; i < result.Length; i++)
{
Write($"{result[i]:X2} ");
if (i % 16 == 7)
{
Write(" ");
}
else if (i % 16 == 15)
{
WriteLine();
}
}
WriteLine();
}
テキストファイル
テキストファイルの読み込みと書き込み
StreamReaderクラスを使用して、
テキストファイルの読み込みと書き込み、using構文によるファイルのクローズ、例外処理等を記載する。
テキストファイルの内容を読み込むには、以下の3つの処理からなる。
- ファイルを開く
- ファイルの内容を読み込む
- ファイルを閉じる
テキストファイルを開く
ファイルを開くにはいくつかの方法が存在するが、UTF-8のファイルを開く場合、
StreamReaderクラス(System.IO名前空間)を使用する。
StreamReader sr = new StreamReader(@"readme.txt", Encoding.UTF8);
また、Shift-JISのファイルを開く場合は、以下のように記述する。
StreamReader sr = new StreamReader(@"readme.txt", Encoding.GetEncoding("Shift_JIS"));
テキストファイルを読み込む
StreamReaderクラスのReadToEndメソッドを使用して、テキストファイルの内容を一括して読み込むことができる。
また、ReadToEndメソッドでは、改行文字等も含めて、全ての1つの文字列として読み込まれる。
usingステートメントを使用してファイルを閉じる
StreamReaderクラスは、IDisposableインタフェースを実装しているため、(スーパークラスのTextReaderクラスが実装している)
Closeメソッドの代わりに、usingステートメントを利用することもできる。
usingステートメントを抜ける時、自動的にStreamReaderクラスのDisposeメソッドを呼び出して、
その中でCloseメソッドが呼び出される。
ファイルが読み込めない時のエラー処理
ファイルが存在しない場合やファイルの読み込み中にディスク等に何らかの障害が発生する場合、
例外が発生してプログラムの実行が中断されるため、例外処理を記述する必要がある。
テキストファイルの一括読み込み(変数の使用)
以下の例では、ReadToEndメソッドを非同期処理に対応したReadToEndAsyncメソッドを使用して、
ファイルの全ての内容を一括して読み込んでいる。
using System;
using System.IO;
using System.Text;
string text = string.Empty;
try
{
using (StreamReader sr = new StreamReader(@"hoge.txt", Encoding.UTF8))
{
text = await sr.ReadToEndAsync();
}
Console.Write(text);
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
ファイルの内容を1行ずつ読み込む
ファイルの全ての内容を1つの変数に読み込むよりも、1行ずつ読み込んで文字列の配列に代入する方が扱いやすい場合がある。
ファイルから1行読み込むには、StreamReaderクラスのReadLineメソッドを使用する。
ReadLineメソッドは、ファイルから1行のみ読み込み、内部で読み取り位置を1行分進める。
読み取り位置がファイルの末尾に達した場合、nullを返す。
なお、.NET Framework 2.0以降では、Fileクラス(System.IO名前空間)において、
ファイルを開く・内容を読み込む・ファイルを閉じるという一連の処理を1つのメソッドで行うReadAllTextメソッドとReadAllLinesメソッドが追加されている。
using System;
using System.IO;
using System.Text;
using System.Collections;
string line = string.Empty;
List<string> list = new List<string>();
try
{
using (StreamReader sr = new StreamReader(@"hoge.txt", Encoding.UTF8))
{
while ((line = await sr.ReadLineAsync()) != null)
{
list.Add(line);
}
}
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
foreach (string strLine in list)
{
Console.WriteLine(strLine);
}
テキストファイルの一括読み込み(変数の使用)
テキストファイルの全ての内容を1つの変数に読み込む場合、FileクラスのReadAllTextメソッドを使用する。
ReadAllTextメソッドで使用する標準の文字コードは、UTF-8である。
以下の例では、テキストファイルの内容を一括して変数に読み込んでいる。
using System.Text;
using System.IO;
try
{ // ファイルの読み込み
string text1 = File.ReadAllText(@"hoge.txt", Encoding.UTF8);
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
テキストファイルの一括読み込み(配列の使用)
テキストを1行ずつ処理する場合、各行を要素とする文字列配列を使用する。
これは、System.IO.FileクラスのReadAllLinesメソッドを使用して実行する。
ReadAllLinesメソッドで使用する標準の文字コードは、UTF-8である。
なお、ReadAllLinesメソッドは、ファイル末尾の改行文字を無視する。
ファイル末尾に改行文字がある場合、ReadAllLinesメソッドで得られる行数は1行少なくなる。
以下の例では、テキストファイルの内容を一括して配列に読み込んでいる。
using System.Text;
using System.IO;
try
{ // ファイルの読み込み
string[] lines1 = File.ReadAllLines(@"hoge.txt", Encoding.UTF8);
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
CSVファイル
CSVファイルを読み込むには、.NET Framework 2.0で追加されたTextFieldParserクラス(Microsoft.VisualBasic.FileIO名前空間)を使用する。
TextFieldParserクラスを使用することで、CSVファイルを読み込み、各行の各フィールドの文字列を簡潔に取得することができる。
CSVファイルを読み込む
TextFieldParserクラスを使用してCSVファイルを読み込むには、
まず、TextFieldParserクラスのコンストラクタに処理するCSVファイルを指定して、インスタンスを生成する。
CSVファイルに日本語が含まれている場合は、文字コードを指定する。
using System.Text;
using Microsoft.VisualBasic.FileIO;
var parser = new TextFieldParser(@"hoge.csv", Encoding.GetEncoding("Shift_JIS")); // 文字コードはShift-JISを指定する
次に、TextFieldTypeプロパティにFieldType.Delimitedを指定する。
もし、FieldType.FixedWidthを指定する場合、フィールドが固定幅のファイルも扱うことができる。
また、SetDelimitersメソッドを使用して、区切り文字を指定する。(複数の区切り文字が指定可能)
CSVファイルの場合は、,(カンマ)を指定する。
parser.TextFieldType = FieldType.Delimited;
parser.SetDelimiters(","); // 区切り文字はカンマを指定する
TextFieldParserクラスのReadFieldsメソッドを実行するごとに、CSVファイルを1行ずつ読むことができる。
ReadFieldsメソッドは、読み込んだレコードの全てのフィールドを文字列配列に変換して返す。
次のレコードが存在するかどうかはEndOfDataプロパティにより判定できるため、ループにより、CSVファイル全体を処理できる。
while (!parser.EndOfData)
{
// 配列rowの要素は読み込んだレコードの各フィールドの値
string[] row = parser.ReadFields(); // 1レコード読み込む
}
CSVファイルを読み込み表示する
以下の例では、hoge.csvファイルを読み込み、各フィールドを切り出してタブ区切りで画面に出力する。
改行文字および空白文字がどのように処理されるかを分かりやすくするために、それぞれをnと_に置換して出力している。
HasFieldsEnclosedInQuotesプロパティ- フィールドに改行やデリミタを含める為に引用符を使っているようなフォーマットを考慮する場合は、
HasFieldsEnclosedInQuotesプロパティをtrueに設定する。(初期値はtrue)
- TrimWhiteSpaceプロパティ
- フィールドの前後の空白文字を削除しない場合は、
TrimWhiteSpaceプロパティをfalseに設定する。(初期値はtrue)
- フィールドの前後の空白文字を削除しない場合は、
using System;
using System.Text;
using Microsoft.VisualBasic.FileIO;
class CSVParser
{
static void Main()
{
using (var parser = new TextFieldParser("text.csv", Encoding.GetEncoding("Shift_JIS")))
{
parser.TextFieldType = FieldType.Delimited; // フィールドはデリミタにより区切る(可変)
parser.Delimiters = new[] {","}; // 区切り文字を指定
parser.CommentTokens = new[] {"#"}; // #で始まる行をコメントとする
// parser.HasFieldsEnclosedInQuotes = false; // 引用符で括られたフィールドを持つか指定
// parser.TrimWhiteSpace = false; // フィールドの前後に含まれる空白を削除するか指定
while (!parser.EndOfData)
{
try
{
string[] row = parser.ReadFields(); // 1行読み込む
foreach (string field in row)
{
field = field.Replace("\r\n", "n"); // 改行をnに置換
field = field.Replace(" ", "_"); // 空白を_に置換
Console.Write(field + "\t"); // タブ区切りで出力
}
Console.WriteLine();
}
catch(Exception ex)
{
Console.WriteLine(ex.Message);
}
}
}
}
}
ファイルを確実に削除する
System.IO.FileクラスのDeleteメソッドを使用する場合、読み取り専用ファイルに対して実行すると例外が発生する。
これを解決するには、ファイルを削除する前に、ファイルの読み取り専用属性を解除する。
以下の例では、ファイルの読み取り専用属性を解除して、ファイルを削除している。
public static void main(string[] args)
{
// 読み取り専用ファイルの場合でも削除する
DeleteFile(@"C:\Hoge\");
}
/// -----------------------------------------------------------------------------
/// <summary>
/// 指定したファイルを削除する</summary>
/// <param name="stFilePath">
/// 削除するファイルまでのパス</param>
/// -----------------------------------------------------------------------------
public static void DeleteFile(string stFilePath)
{
System.IO.FileInfo cFileInfo = new System.IO.FileInfo(stFilePath);
// ファイルが存在しているか判断する
if(cFileInfo.Exists)
{
// 読み取り専用属性がある場合は、読み取り専用属性を解除する
if((cFileInfo.Attributes & System.IO.FileAttributes.ReadOnly) == System.IO.FileAttributes.ReadOnly)
{
cFileInfo.Attributes = System.IO.FileAttributes.Normal;
}
// ファイルを削除する
cFileInfo.Delete();
}
}