Создание документа с пространствами имен в C# (LINQ to XML)
В этой статье показано, как создавать документы в C# с пространствами имен.
Пример: Объявление и инициализация пространства имен по умолчанию
Чтобы создать элемент или атрибут, который находится в пространстве имен, сначала объявите и инициализируете объект XNamespace. Затем вы используете перегрузку оператора сложения для объединения пространства имен с локальным именем, выраженным в виде строки.
В следующем примере создается документ с одним пространством имен. По умолчанию LINQ to XML сериализует этот документ с использованием заданного пространства имен.
// Create an XML tree in a namespace.
XNamespace aw = "http://www.adventure-works.com";
XElement root = new XElement(aw + "Root",
new XElement(aw + "Child", "child content")
);
Console.WriteLine(root);
В этом примере создаются следующие выходные данные:
<Root xmlns="http://www.adventure-works.com">
<Child>child content</Child>
</Root>
Пример. Создание документа с пространством имен и атрибутом
В следующем примере создается документ с одним пространством имен. Он также создает атрибут, который объявляет пространство имен с использованием префикса пространства имен. Чтобы создать атрибут, объявляющий пространство имен с префиксом, создайте атрибут, в котором имя атрибута является префиксом пространства имен, и это имя находится в пространстве имен Xmlns. Значение этого атрибута — URI пространства имен.
// Create an XML tree in a namespace, with a specified prefix
XNamespace aw = "http://www.adventure-works.com";
XElement root = new XElement(aw + "Root",
new XAttribute(XNamespace.Xmlns + "aw", "http://www.adventure-works.com"),
new XElement(aw + "Child", "child content")
);
Console.WriteLine(root);
В этом примере создаются следующие выходные данные:
<aw:Root xmlns:aw="http://www.adventure-works.com">
<aw:Child>child content</aw:Child>
</aw:Root>
Пример. Создание документа с двумя пространствами имен, одним из них с префиксом
В следующем примере показано создание документа, содержащего два пространства имен. Одно из них — это пространство имен по умолчанию, а другое — пространство имен с префиксом.
Включив атрибуты пространства имен в корневой элемент, пространства имен сериализуются таким образом, чтобы http://www.adventure-works.com
является пространством имен по умолчанию, а www.fourthcoffee.com
сериализуется с префиксом fc
. Чтобы создать атрибут, объявляющий пространство имен по умолчанию, создайте атрибут с именем xmlns
без пространства имен. Значение атрибута — URI пространства имен по умолчанию.
Если объявление пространства имен по умолчанию находится в области, оно применяется к дочерним объектам XElement
путем префикса их локальных имен с соответствующим объектом XNamespace
. С другой стороны, объявления пространства имен по умолчанию не применяются непосредственно к именам атрибутов. Таким образом, объекты XAttribute
в пространстве имен по умолчанию определяются не добавлением префикса к их локальному имени, а соответствующим объектом из XNamespace
.
// The http://www.adventure-works.com namespace is forced to be the default namespace.
XNamespace aw = "http://www.adventure-works.com";
XNamespace fc = "www.fourthcoffee.com";
XElement root = new XElement(aw + "Root",
new XAttribute("xmlns", "http://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 XAttribute("DefaultNs", "default namespace"),
new XAttribute(fc + "PrefixedNs", "prefixed namespace")
),
new XElement(fc + "Child3", "c3 content",
new XAttribute("DefaultNs", "default namespace"),
new XAttribute(fc + "PrefixedNs", "prefixed namespace")
)
);
Console.WriteLine(root);
В этом примере создаются следующие выходные данные:
<Root xmlns="http://www.adventure-works.com" xmlns:fc="www.fourthcoffee.com">
<fc:Child>
<DifferentChild>other content</DifferentChild>
</fc:Child>
<Child2 DefaultNs="default namespace" fc:PrefixedNs="prefixed namespace">c2 content</Child2>
<fc:Child3 DefaultNs="default namespace" fc:PrefixedNs="prefixed namespace">c3 content</fc:Child3>
</Root>
Пример: Создайте документ с двумя пространствами имен, оба с префиксами.
В следующем примере создается документ, содержащий два пространства имен, оба с префиксами.
XNamespace aw = "http://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="http://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 должен проанализировать имя, найти атомизованное пространство имен и найти атомизованное имя. Этот процесс занимает время ЦП. Если производительность важна, может потребоваться явно объявить и использовать объект XNamespace.
Если производительность является важной проблемой, см. дополнительные сведения в о предварительной атомизации объектов XName.
// Create an XML tree in a namespace, with a specified prefix
XElement root = new XElement("{http://www.adventure-works.com}Root",
new XAttribute(XNamespace.Xmlns + "aw", "http://www.adventure-works.com"),
new XElement("{http://www.adventure-works.com}Child", "child content")
);
Console.WriteLine(root);
В этом примере создаются следующие выходные данные:
<aw:Root xmlns:aw="http://www.adventure-works.com">
<aw:Child>child content</aw:Child>
</aw:Root>