方法 : 名前空間を持つドキュメントを作成する (C#) (LINQ to XML)
更新 : November 2007
このトピックでは、名前空間を持つドキュメントを作成する方法について説明します。
使用例
名前空間にある要素や属性を作成するには、最初に XNamespace オブジェクトを宣言して初期化します。次に、加算演算子オーバーロードを使用して名前空間をローカル名に連結し、文字列として表します。
次の例では、1 つの名前空間を持つドキュメントを作成します。既定では、LINQ to XML によって、このドキュメントが既定の名前空間でシリアル化されます。
// Create an XML tree in a namespace.
XNamespace aw = "https://www.adventure-works.com";
XElement root = new XElement(aw + "Root",
new XElement(aw + "Child", "child content")
);
Console.WriteLine(root);
この例では次の出力が生成されます。
<Root xmlns="https://www.adventure-works.com">
<Child>child content</Child>
</Root>
次の例では、1 つの名前空間を持つドキュメントを作成します。名前空間プレフィックスを持つ名前空間を宣言する属性も作成します。プレフィックス付きの名前空間を宣言する属性を作成するには、属性名が名前空間プレフィックスで、この名前が Xmlns 名前空間にある属性を作成します。この属性の値は名前空間の URI です。
// Create an XML tree in a namespace, with a specified prefix
XNamespace aw = "https://www.adventure-works.com";
XElement root = new XElement(aw + "Root",
new XAttribute(XNamespace.Xmlns + "aw", "https://www.adventure-works.com"),
new XElement(aw + "Child", "child content")
);
Console.WriteLine(root);
この例では次の出力が生成されます。
<aw:Root xmlns:aw="https://www.adventure-works.com">
<aw:Child>child content</aw:Child>
</aw:Root>
次の例では、2 つの名前空間が含まれるドキュメントを作成します。1 つは既定の名前空間です。もう 1 つは、プレフィックスを持つ名前空間です。
ルート要素に名前空間属性を含めると名前空間がシリアル化され、https://www.adventure-works.com が既定の名前空間となり、www.fourthcoffee.com はプレフィックス "fc" でシリアル化されます。既定の名前空間を宣言する属性を作成するには、"xmlns" という名前の属性を、名前空間を指定せずに作成します。属性の値は、既定の名前空間 URI です。
// The https://www.adventure-works.com namespace is forced to be the default namespace.
XNamespace aw = "https://www.adventure-works.com";
XNamespace fc = "www.fourthcoffee.com";
XElement root = new XElement(aw + "Root",
new XAttribute("xmlns", "https://www.adventure-works.com"),
new XAttribute(XNamespace.Xmlns + "fc", "www.fourthcoffee.com"),
new XElement(fc + "Child",
new XElement(aw + "DifferentChild", "other content")
),
new XElement(aw + "Child2", "c2 content"),
new XElement(fc + "Child3", "c3 content")
);
Console.WriteLine(root);
この例では次の出力が生成されます。
<Root xmlns="https://www.adventure-works.com" xmlns:fc="www.fourthcoffee.com">
<fc:Child>
<DifferentChild>other content</DifferentChild>
</fc:Child>
<Child2>c2 content</Child2>
<fc:Child3>c3 content</fc:Child3>
</Root>
次の例では、名前空間プレフィックスのある名前空間を 2 つ含むドキュメントを作成します。
XNamespace aw = "https://www.adventure-works.com";
XNamespace fc = "www.fourthcoffee.com";
XElement root = new XElement(aw + "Root",
new XAttribute(XNamespace.Xmlns + "aw", aw.NamespaceName),
new XAttribute(XNamespace.Xmlns + "fc", fc.NamespaceName),
new XElement(fc + "Child",
new XElement(aw + "DifferentChild", "other content")
),
new XElement(aw + "Child2", "c2 content"),
new XElement(fc + "Child3", "c3 content")
);
Console.WriteLine(root);
この例では次の出力が生成されます。
<aw:Root xmlns:aw="https://www.adventure-works.com" xmlns:fc="www.fourthcoffee.com">
<fc:Child>
<aw:DifferentChild>other content</aw:DifferentChild>
</fc:Child>
<aw:Child2>c2 content</aw:Child2>
<fc:Child3>c3 content</fc:Child3>
</aw:Root>
XNamespace オブジェクトを宣言して作成する代わりに、展開名を使用しても同じ結果が得られます。
ただし、この方法はパフォーマンスに影響を与えます。展開名が含まれた文字列を LINQ to XML に渡すたびに、LINQ to XML は名前を解析して、アトミック化された名前空間を検索し、アトミック化された名前を見つける必要があります。この処理は CPU 時間を消費します。パフォーマンスが重要な場合には、XNamespace オブジェクトを明示的に宣言して使用することをお勧めします。
パフォーマンスが重要な要件の場合、詳細については、「XName オブジェクトの事前アトミック化 (LINQ to XML)」を参照してください。
// Create an XML tree in a namespace, with a specified prefix
XElement root = new XElement("{https://www.adventure-works.com}Root",
new XAttribute(XNamespace.Xmlns + "aw", "https://www.adventure-works.com"),
new XElement("{https://www.adventure-works.com}Child", "child content")
);
Console.WriteLine(root);
この例では次の出力が生成されます。
<aw:Root xmlns:aw="https://www.adventure-works.com">
<aw:Child>child content</aw:Child>
</aw:Root>