C#のJSON・XML操作と例外処理入門！エラーを防ぐ書き方を徹底解説
生徒
「C#でJSONやXMLというファイルを読み書きしたいのですが、時々原因不明のエラーで止まってしまいます。どうすればいいですか？」
先生
「データの形式が正しくなかったり、ファイルが見つからなかったりするとエラーが発生します。それを上手に処理するのが例外処理という技術です。」
生徒
「例外処理を使えば、プログラムが急に終了するのを防げるんですね！具体的な書き方を教えてください。」
先生
「もちろんです。初心者の方向けに、JSONとXMLの扱い方と、安全なプログラムの作り方を順番に説明していきますね！」
1. JSONとXMLとは何かを知ろう
プログラミングの世界では、データを保存したり、他のプログラムにデータを渡したりするために特定の形式を使います。その代表的なものがJSON（ジェイソン）とXML（エックスエムエル）です。
JSONは、JavaScript Object Notationの略で、人間が見てもコンピュータが見ても理解しやすい、現在最も人気のあるデータ形式です。書き方がシンプルで、中身が軽いのが特徴です。一方、XMLはExtensible Markup Languageの略で、タグを使ってデータの意味を表現します。昔から多くのシステムで使われてきた信頼のある形式です。
C#でこれらのデータを扱うとき、最も大切なのがシリアル化と逆シリアル化という作業です。シリアル化とは、プログラム内のデータをJSONなどの文字データに変換すること、逆シリアル化とはその逆で、文字データをプログラムで使える形に戻すことを指します。この変換作業中に、データの書き間違いなどがあるとプログラムが壊れてしまうため、対策が必要になります。
2. プログラムが止まる原因「例外」とは？
プログラムを実行している最中に、予期しない問題が発生して動作が継続できなくなることを例外（れいがい）と呼びます。例えば、「読み込もうとしたJSONファイルの書き方が間違っていた」「指定した場所にファイルが存在しなかった」といった状況です。
初心者のうちは、エラーが出ると「自分の書いたプログラムが全部ダメなんだ」と思いがちですが、そうではありません。例外は「今の状態ではこれ以上進めません」というコンピュータからのサインです。このサインを事前に受け止めて、適切に対処するための仕組みが例外処理（try-catch文）です。これを使わないと、アプリは突然真っ暗になって終了してしまいますが、これを使えば「エラーが発生したので確認してください」という優しいメッセージを出すことができます。
3. JSON操作の基本とエラー対策
まずは、現代のプログラミングでよく使われるJSONの操作を見てみましょう。C#では「System.Text.Json」という標準の機能を使って簡単に操作できます。しかし、インターネットから取得したJSONデータが壊れていることは珍しくありません。以下のコードでは、わざと壊れたJSONを読み込もうとしたときにどうなるかを確認します。
using System;
using System.Text.Json;
public class Program
{
public static void Main()
{
// 形式が正しくないJSONデータ（最後にカンマが足りないなど）
string invalidJson = "{ \"Name\": \"田中\", \"Age\": 25 ";
try
{
// 逆シリアル化（JSONを解析してオブジェクトに変換）を試みる
var data = JsonSerializer.Deserialize<dynamic>(invalidJson);
Console.WriteLine("読み込みに成功しました。");
}
catch (JsonException ex)
{
// JSONの形式が間違っている場合にここが実行される
Console.WriteLine("JSONの形式が正しくありません！内容を確認してください。");
Console.WriteLine("エラーの詳細: " + ex.Message);
}
catch (Exception ex)
{
// その他の予期せぬエラーの場合
Console.WriteLine("何らかのエラーが発生しました。");
}
}
}
JSONの形式が正しくありません！内容を確認してください。
エラーの詳細: ' ' is an invalid start of a property name...
このコードでは、tryの中にエラーが起きそうな処理を書き、catchの中にエラーが起きたときの対応を書きます。JsonExceptionはJSON特有の問題を捕まえるための専用の網のようなものです。
4. XML操作における注意点と例外処理
次に、XMLの操作についてです。XMLは<tag>データ</tag>という形式でデータを囲みます。タグの閉じ忘れや、開始タグと終了タグの名前が違うといったミスがよく起こります。XMLを扱うときは、専用の例外クラスであるXmlExceptionを意識することが重要です。
using System;
using System.Xml;
using System.IO;
public class Program
{
public static void Main()
{
// 閉じタグが間違っているXML
string wrongXml = "<User><Name>佐藤</Name><Age>30</Age>"; // </User>が足りない
try
{
XmlDocument doc = new XmlDocument();
doc.LoadXml(wrongXml); // XMLの読み込みを試みる
Console.WriteLine("XMLの読み込みに成功しました。");
}
catch (XmlException ex)
{
// XML特有の文法エラーを捕まえる
Console.WriteLine("XMLの構造が壊れています。タグの対応を確認してください。");
Console.WriteLine("エラーの場所: 行 " + ex.LineNumber + ", 位置 " + ex.LinePosition);
}
catch (FileNotFoundException)
{
// ファイルが見つからなかった場合
Console.WriteLine("指定されたファイルが存在しません。");
}
}
}
XMLの構造が壊れています。タグの対応を確認してください。
エラーの場所: 行 1, 位置 37
XMLの場合は、エラーが発生した具体的な場所（行数や位置）を取得できるプロパティがあるため、開発者が原因を特定しやすくなっています。これも例外処理をしっかり書いているからこそ得られる情報です。
5. ファイル操作が絡むときの落とし穴
JSONやXMLは、多くの場合「ファイル」としてパソコンの中に保存されています。そのため、データの中身だけでなく「ファイルそのもの」に関するエラーにも注意しなければなりません。例えば、他のソフトがそのファイルを開いていて編集できない状態（ロックされている状態）や、そもそもファイルを開く権限がないといったケースです。
初心者の方が忘れがちなのが、ファイルを読み書きした後に「ファイルを閉じる」という作業です。最近のC#では自動で閉じてくれる仕組みもありますが、例外が発生したときに中途半端にファイルを開きっぱなしにしてしまうと、次にプログラムを動かしたときにエラーになります。これを防ぐのがfinallyというブロックです。finallyに書かれた処理は、エラーが起きても起きなくても、最後に必ず実行されます。
6. try-catchをどこまで細かく書くべきか
全てのコードを一つの大きなtry-catchで囲んでしまうのは、あまり良い書き方ではありません。なぜなら、どこでエラーが起きたのかが分かりにくくなってしまうからです。理想的なのは、「失敗する可能性がある場所」をピンポイントで囲むことです。
また、何でもかんでもcatch (Exception ex)で捕まえてしまうのも注意が必要です。Exceptionは全てのエラーの親玉のような存在なので、どんなエラーも捕まえてしまいます。しかし、プログラミングでは「ファイルがない場合」と「インターネットがつながらない場合」で、出すべきメッセージや対処法が違います。できるだけ、そのエラーに合わせた専用の例外クラスを使うように心がけましょう。
using System;
using System.IO;
public class FileReadExample
{
public void ReadData(string path)
{
try
{
string content = File.ReadAllText(path);
Console.WriteLine("ファイルの中身: " + content);
}
catch (FileNotFoundException)
{
Console.WriteLine("エラー：ファイルが見つかりません。パスが正しいか確認してください。");
}
catch (UnauthorizedAccessException)
{
Console.WriteLine("エラー：ファイルへのアクセス権限がありません。");
}
catch (IOException ex)
{
Console.WriteLine("エラー：ファイルの読み込み中に問題が発生しました。 " + ex.Message);
}
}
}
7. 文字コードとエンコーディングの問題
JSONやXMLを扱うときに意外とハマるのが「文字化け」です。日本語を含むファイルを読み込むとき、そのファイルが「UTF-8」で作られているのか「Shift-JIS」で作られているのかによって、中身が正しく読み取れないことがあります。これは厳密にはプログラムの文法エラーではありませんが、意図しないデータが入ってくるという意味では例外処理とセットで考えるべき課題です。
現代の標準は「UTF-8」ですが、古いシステムで書き出されたXMLなどは別の形式になっていることがあります。読み込み時に文字コードを指定しないと、実行時にデータが支離滅裂になり、その後のJSON解析などで例外が発生してしまいます。外部のファイルを取り扱うときは、常に「このデータの形式は何か」を疑う姿勢が大切です。
8. ヌル参照（NullReferenceException）への対策
JSONやXMLを逆シリアル化して、無事にオブジェクトに変換できたとしても、油断は禁物です。もし読み込んだデータの中に特定の項目が欠けていた場合、その項目にアクセスしようとするとNullReferenceException（ヌル参照例外）が発生します。これは、中身が空っぽ（null）のものを触ろうとしたときに起きる、C#初心者が最も遭遇しやすいエラーです。
対策としては、データを使った処理を行う前に、中身が空ではないかをチェックする癖をつけることです。これを「ガード句」と呼んだりもします。データの読み込み、解析、使用というそれぞれのステップで、一歩一歩安全を確認しながら進むのが、プロ級のプログラムを書くコツです。
using System;
public class User
{
public string Name { get; set; }
}
public class Program
{
public static void Main()
{
User myUser = null; // 本来はJSONから読み込まれるが、失敗してnullになったと仮定
try
{
// myUserがnullなのにプロパティにアクセスしようとする
if (myUser == null)
{
throw new Exception("ユーザーデータが読み込まれていません。");
}
Console.WriteLine(myUser.Name);
}
catch (Exception ex)
{
Console.WriteLine("安全に停止しました: " + ex.Message);
}
}
}
安全に停止しました: ユーザーデータが読み込まれていません。
9. 実践的なエラーログの重要性
アプリを公開したり、誰かに使ってもらったりする場合、エラーが起きたときに画面に難しい英語のエラーを出すだけでは不親切です。かといって、全てのエラーを無視してしまうと、なぜ動かないのか原因が闇の中になってしまいます。
そこで重要になるのが「ログ」です。例外が発生した際、画面には「システムエラーが発生しました」とだけ表示し、裏側では詳しいエラーの内容（日時や原因、場所）をテキストファイルに書き残しておくのです。これにより、後からそのファイルを読んで問題を修正することができます。例外処理は、単にエラーを止めるだけでなく、未来の自分やチームメンバーに「何が起きたか」を伝える重要なコミュニケーションツールでもあるのです。
