C#でXML操作をマスター！XPathで属性や要素を取得する方法を徹底解説
生徒
「C#のプログラムで、インターネットや設定ファイルによく使われるXMLというデータを読み書きしたいのですが、どうすればいいですか？」
先生
「XMLの操作ですね。C#にはXMLを解析するための便利な機能がたくさんあります。特にXPathという書き方を使うと、特定のデータをピンポイントで取り出すことができるんですよ。」
生徒
「XPath...難しそうですね。初心者でも特定の要素や属性の値を簡単に取得できるのでしょうか？」
先生
「大丈夫です！まずはXMLがどのような構造をしているのかという基本から、実際にコードを動かして値を取得する手順まで、ゆっくり丁寧に解説していきますね。」
1. XMLとは何かを理解しよう
プログラミングの世界では、データを保存したり、別のコンピュータに送ったりするための形式がいくつかあります。その代表的なものがXML（エックスエムエル）です。XMLは「Extensible Markup Language」の略で、日本語では「拡張可能なマークアップ言語」と呼ばれます。
マークアップと言われると難しく感じるかもしれませんが、要するに「データにタグをつけて、意味を持たせる仕組み」のことです。例えば、単に「リンゴ」と書くのではなく、<名前>リンゴ</名前>と書くことで、これは名前のデータであるとコンピュータに教えてあげることができます。
XMLは木のような構造（ツリー構造）をしています。一番外側の大きな箱の中に、小さな箱がいくつも入っているイメージです。この箱のことを要素（エレメント）と呼び、箱の中に付いているラベルのような情報を属性（アトリビュート）と呼びます。
2. XMLの構成要素である要素と属性の違い
XMLを操作する上で、まずは「要素」と「属性」の違いをはっきりさせておきましょう。これを知らないと、プログラムでどこを指し示せばよいか迷ってしまいます。
要素とは、<item>...</item>のようにタグで囲まれた部分全体を指します。この中には文字データや、さらに別の要素を入れることができます。一方、属性とは、開始タグの中に書かれる追加情報です。例えば<item id="001">と書いた場合、itemが要素名で、idが属性名、001が属性の値になります。
C#でXMLを扱うときは、この要素の中身（テキスト）を取り出したいのか、それとも属性の値を取り出したいのかを区別してコードを書く必要があります。これができるようになると、大量のデータから必要な情報だけを抜き出すことが可能になります。
3. XPathという住所の指定方法を覚えよう
XMLの中から特定のデータを見つけ出すとき、ファイルの上から順番に探していくのは大変です。そこで登場するのがXPath（エックスパス）です。XPathは、XMLの中にある特定の要素や属性がどこにあるのかを示す「住所」のようなものです。
例えば、パソコンのフォルダ階層を思い浮かべてください。「Cドライブの中のドキュメントフォルダの中のメモ帳ファイル」というように指定しますよね。XPathも同じで、/root/user/nameのようにスラッシュを使って階層を表現します。さらに、属性を指定するときは @ という記号を使います。例えば、id属性を指定したい場合は @id と書きます。
このXPathを使うことで、プログラムは迷うことなく、一瞬で目的のデータにたどり着くことができるようになります。C#にはこのXPathを利用してXMLを検索する便利なライブラリが標準で備わっています。
4. C#でXMLを読み込む準備とライブラリ
C#でXMLを操作するには、専用の道具箱（ライブラリ）を使う必要があります。昔からよく使われているのは System.Xml という名前空間にあるクラス群です。その中でも、XML全体をメモリに読み込んで操作する XmlDocument クラスが初心者には分かりやすいでしょう。
最近では System.Xml.Linq（LINQ to XML）という、より新しくて直感的な方法もありますが、基本を学ぶには XmlDocument と XPath の組み合わせが非常に教育的です。プログラムの冒頭に using System.Xml; と記述することで、これらの機能が使えるようになります。
まずは、簡単なXMLデータを用意して、それをプログラムが読み取れる状態にすることからスタートしましょう。ファイルから読み込むこともできますし、文字列として直接プログラム内に書いたXMLを解析することも可能です。
5. 特定の要素を取得する基本的なコード
それでは、実際にC#のコードを書いてみましょう。以下の例では、果物のリストが書かれたXMLから、特定の要素の名前を取得しています。ここでは SelectSingleNode という命令を使って、XPathで指定した場所にある要素を1つだけ取り出します。
using System;
using System.Xml;
class Program
{
static void Main()
{
// 解析するためのXML文字列を準備します
string xmlData = "<Store><Fruit><Name>リンゴ</Name><Price>150</Price></Fruit></Store>";
// XMLを扱うためのインスタンス（実体）を作ります
XmlDocument doc = new XmlDocument();
// 文字列からXMLを読み込みます
doc.LoadXml(xmlData);
// XPathを使ってName要素を選択します
// /Store/Fruit/Name という住所にある要素を探します
XmlNode node = doc.SelectSingleNode("/Store/Fruit/Name");
if (node != null)
{
// 要素の中にあるテキストを表示します
Console.WriteLine("商品名: " + node.InnerText);
}
}
}
実行結果は以下のようになります。プログラムがXMLの構造を理解し、指定した場所から「リンゴ」という文字だけを抜き出していることがわかります。
商品名: リンゴ
6. 属性の値を取得する方法を学ぼう
次に、要素のタグの中に書かれている「属性」の値を取得する方法を見ていきましょう。属性の取得は、設定ファイルなどから設定値を読み取る際によく使われる技術です。XPathでは @属性名 という書き方を使います。
using System;
using System.Xml;
class Program
{
static void Main()
{
// 属性（id）が含まれているXMLです
string xmlData = "<Users><User id='U001'>田中太郎</User></Users>";
XmlDocument doc = new XmlDocument();
doc.LoadXml(xmlData);
// User要素のid属性を選択するためのXPathです
// 最後に @id を付けるのがポイントです
XmlNode attrNode = doc.SelectSingleNode("/Users/User/@id");
if (attrNode != null)
{
// 属性の値を表示します
Console.WriteLine("ユーザーID: " + attrNode.Value);
}
}
}
実行結果は以下の通りです。タグの中身のテキストではなく、開始タグの中に埋め込まれた id の値を取得できました。
ユーザーID: U001
7. 複数の要素をまとめて取得するループ処理
実際の開発では、データは1つだけでなく、たくさん並んでいることがほとんどです。例えば、複数の商品リストや、複数のユーザー情報などです。これらをすべて取得するには SelectNodes という、複数の要素をまとめて取ってくる命令を使います。
取得した結果はリストのようになっているので、foreach という繰り返し命令を使って、1つずつ処理していくのが一般的です。これにより、データが何個あっても自動的にすべて処理できる柔軟なプログラムになります。
using System;
using System.Xml;
class Program
{
static void Main()
{
// 複数のBook要素があるXMLです
string xmlData = "<Library>" +
"<Book category='プログラミング'>C#入門</Book>" +
"<Book category='料理'>カレーの作り方</Book>" +
"<Book category='歴史'>日本の城</Book>" +
"</Library>";
XmlDocument doc = new XmlDocument();
doc.LoadXml(xmlData);
// すべてのBook要素を取得します
XmlNodeList nodeList = doc.SelectNodes("/Library/Book");
Console.WriteLine("図書一覧を開始します。");
foreach (XmlNode node in nodeList)
{
// category属性と中身のテキストを同時に表示します
string cat = node.Attributes["category"].Value;
string title = node.InnerText;
Console.WriteLine("ジャンル: " + cat + " / タイトル: " + title);
}
}
}
このプログラムを実行すると、XMLに含まれるすべての本の内容が順番に表示されます。
図書一覧を開始します。
ジャンル: プログラミング / タイトル: C#入門
ジャンル: 料理 / タイトル: カレーの作り方
ジャンル: 歴史 / タイトル: 日本の城
8. 条件付きで特定の要素を探し出す応用技
XPathの凄いところは、単に場所を指定するだけでなく、「属性がある値のものだけ」という条件を付けて検索できる点です。これを「述語」と呼びます。例えば、特定のIDを持つユーザーだけを探したり、特定のカテゴリに属するデータだけを抜き出すことが可能です。
書き方は /要素名[@属性名='値'] という形式になります。これにより、プログラム側で大量のデータをif文で仕分けしなくても、XMLを読み込む段階でフィルタリングをかけることができます。効率的でスマートなコードを書くための必須テクニックです。
using System;
using System.Xml;
class Program
{
static void Main()
{
string xmlData = "<Inventory>" +
"<Item code='A100'>消しゴム</Item>" +
"<Item code='B200'>鉛筆</Item>" +
"<Item code='C300'>定規</Item>" +
"</Inventory>";
XmlDocument doc = new XmlDocument();
doc.LoadXml(xmlData);
// 商品コードが B200 の要素だけを直接狙い撃ちします
string targetCode = "B200";
string xpath = "/Inventory/Item[@code='" + targetCode + "']";
XmlNode node = doc.SelectSingleNode(xpath);
if (node != null)
{
Console.WriteLine("コード " + targetCode + " の商品は " + node.InnerText + " です。");
}
else
{
Console.WriteLine("対象の商品が見つかりませんでした。");
}
}
}
このように、XPathを工夫するだけで検索の自由度が格段に上がります。
コード B200 の商品は 鉛筆 です。
9. 初心者がつまずきやすい名前空間の注意点
XMLを扱っていると、たまに xmlns="..." という記述を見かけることがあります。これは名前空間と呼ばれるもので、タグの名前が他のXMLと重複しないようにするための「グループ名」のようなものです。
名前空間が設定されているXMLに対して、これまでの方法でXPathを使ってもデータが取得できないことがあります。これは、プログラム側で「どのグループのタグを探しているか」を明示していないためです。初心者のうちは、名前空間がないシンプルなXMLから練習を始め、慣れてきたら XmlNamespaceManager というクラスの使い方を学ぶのがスムーズな学習の秘訣です。
もし、正しいXPathを書いているはずなのに null（何も見つからない状態）が返ってくる場合は、この名前空間が原因であることが多いので、XMLファイルの最初のタグをよく観察してみましょう。見慣れないURLのような文字列が書いてあったら、それが名前空間のサインです。
10. XML操作をマスターした後の展望
今回は XmlDocument を使った基本的な操作方法を解説しました。C#でXMLが扱えるようになると、アプリケーションの設定を保存するファイルを作ったり、外部のWebサービスから送られてくる情報を解析したりと、できることが一気に広がります。
また、C#には今回紹介した方法以外にも、XMLの内容をそのままクラスの形に変換する「シリアル化（シリアライズ）」という非常に便利なテクニックもあります。これは、XMLのデータをまるで普通のC#の変数のように扱える魔法のような技術です。基礎的な要素の取得方法を理解した後は、そういった自動化の手法にも挑戦してみてください。
プログラミングは、小さな「できた」の積み重ねです。まずは自分の手でXMLの文字を画面に表示させるところから、一歩ずつ進んでいきましょう。XMLを自在に操れるようになれば、あなたはもう初心者脱出と言っても過言ではありません。ぜひ色々なXML構造を作って、実験してみてくださいね。
