今回は、VB.NETでファイルにテキストを書き込む方法についてご紹介します。
VB.NETには複数のファイル書き込み方法が存在し、用途や目的に応じて使い分けることが大切です。
なかでもStreamWriterはコードの可読性やリソース管理のしやすさから、幅広い場面で利用されます。
ここでは書き込みの流れや実装手順、さらにその他の書き込み方法と注意点について整理します。
VB.NETでファイルにテキストを書き込む全体像
テキストファイルを扱う際には、上書きと追記の切り替え、文字コード、リソース解放に気を配る必要があります。
主な方法として、以下のアプローチが挙げられます。
- File.WriteAllText: 簡単なテキスト書き込みなら手軽に利用できます。
- StreamWriter: 行単位の操作や追記モードを扱いやすいのが特徴です。
- My.Computer.FileSystem.WriteAllText: VB.NET固有の便利なメソッドです。
- FileStream + StreamWriter: より細かい制御を必要とするときに有効です。
- 非同期メソッド: UIのブロックを避けたい場合や大きなファイルを扱う場合に利用します。
この中で特に柔軟性の高いStreamWriterを中心に説明を進めます。
StreamWriterでテキストを書き込む方法
StreamWriterを使うと、以下のような特徴が得られます。
- 行単位での書き込みがしやすい
- 上書きモードと追記モードを簡単に切り替えられる
- Usingブロックによるリソースの自動解放が可能
- エンコーディングの指定や例外処理が行いやすい
実際に、StreamWriterを使用してファイルにテキストを書き込む流れを見てみましょう。
基本的な書き込み（上書きモード）
上書きモードとは、既存のファイルを新しい内容で置き換える書き込み方式です。
appendパラメータにFalseを設定することで上書きが可能です。
以下のコード例では、新規のテキストをファイルに書き込み、既存の内容を消去します。
|
1 2 3 4 5 6 7 |
Dim filePath As String = "C:\example.txt" ' 上書きモードでStreamWriterを生成 Using writer As New System.IO.StreamWriter(filePath, append:=False) writer.WriteLine("これは新しいファイルへの書き込み例です。") writer.WriteLine("複数行を書き込む場合に便利です。") End Using |
これは新しいファイルへの書き込み例です。
複数行を書き込む場合に便利です。
上記のようにUsingブロックを用いると、処理が終了した際に自動的にファイルが閉じられます。
明示的にCloseメソッドを呼び出す必要がないため、安全にリソースを解放できます。
追記モードでの書き込み
ファイルの末尾に新しいテキストを追加したい場合は、appendパラメータにTrueを設定します。
既存の内容を保持したまま、新たな行を追加できます。
|
1 2 3 4 5 6 7 |
Dim filePath As String = "C:\example.txt" ' 追記モードでStreamWriterを生成 Using writer As New System.IO.StreamWriter(filePath, append:=True) writer.WriteLine("追記するテキストです。") writer.WriteLine("さらに新しい行を追加しました。") End Using |
追記するテキストです。
さらに新しい行を追加しました。
同じファイルに繰り返しデータを書き足したい場合は、このモードが非常に便利です。
その他のファイル書き込み方法
ここからはStreamWriter以外の代表的な書き込み方法を簡単にご紹介します。
System.IO.File.WriteAllText
File.WriteAllTextは、テキスト全体を一度に書き込むシンプルな手法です。
指定ファイルが存在しない場合は自動的に作成され、存在する場合は上書きされます。
|
1 2 3 4 |
Dim filePath As String = "C:\example.txt" Dim content As String = "こんにちは、世界！" System.IO.File.WriteAllText(filePath, content) |
こんにちは、世界！
行単位の操作が不要であれば、最も手軽に使える方法です。
My.Computer.FileSystem.WriteAllText
VB.NET固有の機能としてMy.Computer.FileSystemがあります。
書き込みモードを引数で切り替えるため、追記したい場合はTrue、上書きしたい場合はFalseを指定します。
|
1 2 3 4 |
Dim filePath As String = "C:\example.txt" Dim content As String = "上書きまたは追記を簡単に切り替えられます。" My.Computer.FileSystem.WriteAllText(filePath, content, append:=False) |
上書きまたは追記を簡単に切り替えられます。
FileStreamとStreamWriterの組み合わせ
ファイルアクセスをより細かく制御したい場合は、FileStreamでファイルを開き、StreamWriterで書き込みを行います。
|
1 2 3 4 5 6 7 |
Dim filePath As String = "C:\example.txt" Using fs As New System.IO.FileStream(filePath, System.IO.FileMode.Create) Using writer As New System.IO.StreamWriter(fs) writer.Write("より低レベルなファイル操作が可能です。") End Using End Using |
より低レベルなファイル操作が可能です。
FileModeやFileAccessなどを細かく指定できるため、特殊な要件があるときに役立ちます。
非同期メソッド
UIスレッドをブロックしたくない場合や、サイズの大きいファイルへの書き込みが必要な場合は、非同期メソッドが有効です。
Async/Awaitを用いることで、書き込みの完了を待つあいだに他の処理を実行できます。
|
1 2 3 4 5 6 7 8 9 |
Imports System.IO Imports System.Threading.Tasks Public Async Function WriteTextAsync() As Task Dim filePath As String = "C:\example.txt" Dim content As String = "こんにちは、非同期での書き込み！" Await File.WriteAllTextAsync(filePath, content) End Function |
(ファイルに「こんにちは、非同期での書き込み！」と書き込まれます)
長時間かかる処理もUIがフリーズしにくくなるため、ユーザー体験の向上が期待できます。
注意点
ファイルパスを指定するときは、パスが存在するディレクトリであるかを確認してください。
エンコーディングを指定せずに日本語などを扱う場合、文字化けが発生する可能性があります。
例外処理として、IOExceptionやUnauthorizedAccessExceptionなどを考慮しましょう。
同時アクセスの可能性がある場合、排他制御や同期処理を導入すると安全です。
非同期メソッドを使う際はエラーハンドリングとリソース管理を慎重に行ってください。
まとめ
この記事では、VB.NETでファイルにテキストを書き込むための主な方法として、StreamWriterを中心に紹介しました。
書き込みモードやエンコーディングの指定など、目的に合わせた調整がポイントになります。
用途や要件に応じて複数の方法を検討し、効率的なファイル操作を実現してみてください。
