XMLをC#クラスに変換（XmlSerializer）

.NETのXmlSerializerでXMLをオブジェクトに読み込むには、ドキュメントと正確に対応する属性を持つクラスが必要です。ルートには[XmlRoot]、子要素には[XmlElement]、属性には[XmlAttribute]、属性と並ぶテキストには[XmlText]です。サンプルのドキュメントを貼り付けると、それらのクラスが得られます。繰り返される要素はList<T>になり、数値・真偽値・日付は型付けされ、省略可能な値はXmlSerializerが求める方法で処理され、名前空間も引き継がれます。

使い方

1. 代表的なXMLドキュメントを貼り付けます。省略可能な要素や繰り返しをどこかに含めてください。
2. 必要に応じてC#の名前空間を入力します。
3. 値に型を付ける（int、decimal、bool、DateTime）か、文字列のままにするかを選びます。
4. クラスをコピーし、new XmlSerializer(typeof(Root))でデシリアライズします。

計算式

ルート → [XmlRoot]クラス · 属性 → [XmlAttribute] · 子要素 → [XmlElement] · 繰り返される子 → List<T> · 属性と並ぶテキスト → [XmlText]

テキストだけの要素は、単純な型のプロパティになります。範囲に応じてintまたはlong、decimal、bool（true/false）、DateTime（xs:dateTimeまたはxs:date。後者はDataType = "date"つき）、それ以外はstringで、空の出現が1回でもあればstringのままです。属性や子を持つ要素はクラスになり、構造が同じなら共有されます。値型の省略可能な要素はT?になりますが、値型の省略可能な属性には…Specifiedフラグが付きます。XmlSerializerがnull許容の属性をサポートしていないためです。

計算例

サンプルのcatalogからは3つのクラスができます。CatalogにはList<Book> Books（[XmlElement("book")]）があります。Bookには、Id（string）、Available（boolで、最初の本にしかないためAvailableSpecifiedが付く）、Author、Title、Price、Published（DateTime、DataType = "date"）、List<string> Tagsがあります。Priceには、currency属性と、44.95または5.95を保持するdecimalの[XmlText] Valueがあります。