C#でJSONとXMLを相互変換！初心者向け完全ガイドと実践テクニック
生徒
「C#でデータを保存したり読み込んだりするときに、JSONとかXMLっていう言葉をよく聞くのですが、これって何ですか？」
先生
「JSONやXMLは、コンピューターが情報を整理してやり取りするための専用の書き方のルールのことですよ。C#を使えば、この2つを自由に入れ替えたり、中身を読み取ったりすることが簡単にできるんです。」
生徒
「難しそうに見えますが、初心者でも変換したり扱ったりできますか？」
先生
「もちろんです！まずは基本となる仕組みから、実際の変換コードまで順番に見ていきましょう。」
1. JSONとXMLとは何かを知ろう
プログラミングの世界では、情報を整理して保存するための形式がいくつかあります。その代表格がJSON（ジェイソン）とXML（エックスエムエル）です。これらは「データ記述言語」と呼ばれ、人間が見ても内容が理解しやすく、コンピューターにとっても処理しやすいという特徴があります。
例えば、ある個人の情報を管理したいとき、名前や年齢、住所といった項目をバラバラに扱うのではなく、一つのまとまった塊として表現します。JSONはJavaScriptという言語から派生した書き方で、最近のWeb開発では主流となっています。対してXMLは、HTMLのようにタグを使ってデータを囲む形式で、古くから多くのシステムで利用されてきました。
C#というプログラミング言語は、これらの形式を扱うのが非常に得意です。標準の機能やライブラリ（便利な道具セット）を使うことで、数行のコードを書くだけでJSONをXMLに変えたり、その逆を行ったりすることができます。
2. なぜ変換が必要になるのか
なぜJSONとXMLを変換する必要があるのでしょうか。それは、システムによって「話せる言葉」が違うからです。例えば、あなたが開発している最新のアプリがJSONで情報をやり取りしていても、連携先の古い銀行システムや在庫管理システムがXMLしか受け付けてくれない場合があります。このようなときに、アプリ内部でデータを変換してあげる必要が出てきます。
また、設定ファイルとしてXMLを採用しているツールからデータを取り出し、それをWebサイトで表示するためにJSONへ変換するといったケースも頻繁にあります。このように、異なるシステム同士の橋渡し役として、C#によるデータ変換技術は非常に重要です。この技術を習得することで、扱えるデータの幅が大きく広がり、プログラマーとしての実力も一段階アップします。
3. 準備：ライブラリを導入しよう
C#でJSONとXMLを効率よく扱うためには、Newtonsoft.Json（通称：Json.NET）という非常に有名なライブラリを使用するのが一般的です。これは世界中のプログラマーが愛用しているツールで、複雑な変換処理を肩代わりしてくれます。Visual Studioなどの開発環境では「NuGetパッケージマネージャー」という機能を使って簡単にインストールできます。
もちろん、C#の標準機能であるSystem.Text.Jsonを使う方法もありますが、XMLとの相互変換についてはNewtonsoft.Jsonが非常に強力なサポート機能を持っています。まずは、このライブラリを使って、どのようにデータを定義し、どのように変換の準備を整えるのかを学んでいきましょう。プログラムの冒頭にusing Newtonsoft.Json;と書き込むことで、その魔法の力を使えるようになります。
4. JSONからXMLへ変換する具体的な方法
それでは、実際にJSON形式の文字列をXML形式に変換してみましょう。以下のコード例では、JSONのデータを一度「JObject」や「XmlNode」といった、プログラムが扱いやすい中間的な形に変換してから、XMLの文字列へと出力しています。初心者の方でも、コードの流れを追えば何が行われているか掴めるはずです。
using System;
using System.Xml;
using Newtonsoft.Json;
class Program
{
static void Main()
{
// 1. JSON形式のデータを用意します
string json = "{ \"User\": { \"Name\": \"田中太郎\", \"Age\": 25, \"City\": \"東京\" } }";
// 2. JSONをXMLドキュメントに変換します
// DeserializeXmlNodeという便利な命令を使います
XmlDocument xmlDoc = JsonConvert.DeserializeXmlNode(json, "Root");
// 3. 結果を表示します
Console.WriteLine(xmlDoc.InnerXml);
}
}
実行結果は以下のようになります。JSONで書かれていたデータが、しっかりとXMLのタグ形式に書き換わっているのがわかりますね。
<Root><User><Name>田中太郎</Name><Age>25</Age><City>東京</City></User></Root>
ここで出てきたDeserialize（デシリアライズ）という言葉は、直訳すると「復元する」という意味です。文字列という単なる文字の並びを、コンピューターが構造として理解できる状態に戻すことを指します。逆に、構造を文字列にすることをSerialize（シリアライズ）と言います。この用語はテストにもよく出る重要な概念です。
5. XMLからJSONへ変換するテクニック
次は逆のパターンです。XML形式のデータをJSON形式に変換します。古いシステムから送られてきたXMLデータを、モダンなWebアプリで使いやすいJSONに直すシーンを想像してください。この変換も、Newtonsoft.Jsonを使えば驚くほどシンプルに記述できます。
using System;
using System.Xml;
using Newtonsoft.Json;
class Program
{
static void Main()
{
// 1. XML形式の文字列を用意します
string xml = "<Item><Id>101</Id><Name>ノートパソコン</Name><Price>85000</Price></Item>";
// 2. XMLを読み込むための箱（XmlDocument）を作ります
XmlDocument doc = new XmlDocument();
doc.LoadXml(xml);
// 3. XMLからJSONへ変換します
string json = JsonConvert.SerializeXmlNode(doc);
// 4. 結果を表示します
Console.WriteLine(json);
}
}
実行結果を確認してみましょう。タグ形式だったデータが、波括弧{}を使ったJSON形式に生まれ変わりました。
{"Item":{"Id":"101","Name":"ノートパソコン","Price":"85000"}}
このように、C#を使えばどちらの方向への変換も自由自在です。プログラム未経験の方でも、「決まった型に流し込んで、変換の命令を出すだけ」と考えると、少し気が楽になるのではないでしょうか。実際、プログラミングの多くは、こうした既存の便利な道具をいかに上手に組み合わせるかというパズルのような側面があります。
6. 変換時に注意すべきポイントとコツ
JSONとXMLは似て非なるものです。そのため、変換するときにはいくつか注意点があります。最大のポイントは「配列（リスト）」の扱いです。JSONでは同じ項目が並ぶときには[]を使ってスマートに表現しますが、XMLでは同じ名前のタグを繰り返して表現します。この違いが原因で、変換後の形が思い通りにならないことがたまにあります。
また、属性（アトリビュート）の扱いも異なります。XMLには<Person id="1">のようにタグの中に情報を埋め込む書き方がありますが、JSONにはそのような概念がありません。変換ライブラリは通常、これらを区別するために特別な記号（@マークなど）を付与することがあります。変換後のデータを別のシステムで使う場合は、そのデータが相手の期待する形になっているか、必ず中身を確認する癖をつけましょう。
7. クラスを使った高度なデータ操作
ここまでは文字列を直接変換してきましたが、実際の開発では「クラス」という設計図を使ってデータを管理します。クラスを使うと、名前は文字列（string）、年齢は数値（int）といったように、データの種類を厳格に決めることができます。これにより、プログラムの間違いを未然に防ぐことが可能になります。クラスを経由してJSONやXMLを扱う方法こそが、C#プログラミングの真髄です。
using System;
using System.Collections.Generic;
using Newtonsoft.Json;
// データの設計図（クラス）を作ります
public class Product
{
public string Name { get; set; }
public int Stock { get; set; }
}
class Program
{
static void Main()
{
// クラスから実体（オブジェクト）を作ります
Product myProduct = new Product { Name = "消しゴム", Stock = 50 };
// オブジェクトをJSONに変換します
string json = JsonConvert.SerializeObject(myProduct);
Console.WriteLine("JSON出力: " + json);
// JSONからオブジェクトに戻すことも可能です
Product deserialized = JsonConvert.DeserializeObject<Product>(json);
Console.WriteLine("復元した名前: " + deserialized.Name);
}
}
実行結果は以下の通りです。
JSON出力: {"Name":"消しゴム","Stock":50}
復元した名前: 消しゴム
この手法をマスターすれば、インターネット上のWebAPIからJSONを取得し、それを自分たちのプログラムで使いやすいクラスの形に変換して、さらに必要に応じてXMLで保存する、といった高度な処理もスムーズに行えるようになります。クラスは「情報の入れ物」であり、シリアライズはその入れ物を「配送用の箱（文字列）」に詰め込む作業だとイメージすると分かりやすいでしょう。
8. エラーが起きたときの対処法
プログラムにエラーは付きものです。変換中に「文字の形がおかしいですよ」と怒られてしまうこともあります。よくある原因は、JSONの閉じカッコ}を忘れていたり、XMLのタグが正しく閉じられていなかったりするケアレスミスです。また、日本語を扱う場合には「文字化け」に注意が必要です。C#は基本的にUTF-8という文字コードを推奨していますので、読み書きするファイルがこの形式になっているか確認しましょう。
エラーが発生したときは、エラーメッセージをよく読んでください。「〇行目の付近がおかしい」と親切に教えてくれることが多いです。また、変換前のデータが空っぽ（null）でないかチェックする処理を入れるのも、プロのエンジニアへの第一歩です。慎重に一つずつ確認していけば、必ず解決の糸口が見つかります。失敗を恐れずに、色々なデータを変換して試してみることが上達への近道です。
9. 実践！複数のデータをまとめて変換する
最後に応用編として、複数のデータ（リスト）を扱う例を見てみましょう。現実のアプリケーションでは、一人のユーザーだけでなく、何百人ものユーザーデータを一気に処理することがよくあります。C#のListという機能を使えば、複数のデータをまとめて管理し、それを一括でJSONやXMLに変換できます。
using System;
using System.Collections.Generic;
using Newtonsoft.Json;
class Program
{
static void Main()
{
// リストを使って複数のデータを作ります
List<string> fruits = new List<string> { "りんご", "みかん", "ぶどう" };
// リスト全体をJSONに変換します
string json = JsonConvert.SerializeObject(fruits, Formatting.Indented);
// 画面に表示します
Console.WriteLine(json);
}
}
実行結果は以下のようになります。Formatting.Indentedというオプションを付けると、人間が見やすいように段落（インデント）を付けて出力してくれます。こうしたちょっとした気遣いが、開発効率を大きく変えるポイントになります。
[
"りんご",
"みかん",
"ぶどう"
]
このように、単体のデータから複数のデータの塊まで、C#とライブラリを組み合わせることで自由自在に操ることができます。まずは小さなデータから練習を始め、徐々に複雑な構造に挑戦していきましょう。一歩ずつ進めば、あなたも立派なC#プログラマーになれるはずです。プログラミングの楽しさは、自分の書いたコードが意図した通りに動いた瞬間にあります。今回のJSONとXMLの変換も、その喜びを感じる素晴らしい体験になるでしょう。
