Como criar um documento com namespaces (C#) (LINQ to XML)
Este tópico mostra como criar documentos com namespaces.
Exemplo
Para criar um elemento ou um atributo que esteja em um namespace, você primeiro declara e inicializa um objeto XNamespace. Em seguida, você usa a sobrecarga do operador de adição para combinar o namespace com o nome local, expresso como uma cadeia de caracteres.
O exemplo a seguir cria um documento com um namespace. Por padrão, o LINQ to XML serializa esse documento com um namespace padrão.
// 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);
Este exemplo gera a seguinte saída:
<Root xmlns="https://www.adventure-works.com">
<Child>child content</Child>
</Root>
O exemplo a seguir cria um documento com um namespace. Também cria um atributo que declara o namespace com um prefixo de namespace. Para criar um atributo que declare um namespace com um prefixo, você cria um atributo onde o namespace do nome do atributo seja o prefixo do namespace, e esse nome esteja no namespace Xmlns. O valor desse atributo é o URI do namespace.
// 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);
Este exemplo gera a seguinte saída:
<aw:Root xmlns:aw="https://www.adventure-works.com">
<aw:Child>child content</aw:Child>
</aw:Root>
O exemplo a seguir mostra a criação de um documento que contém dois namespaces. Um é o namespace padrão. O outro é um namespace com um prefixo.
Com a inclusão de atributos de namespace no elemento raiz, os namespaces são serializados de modo que https://www.adventure-works.com seja o namespace padrão, e www.fourthcoffee.com seja serializado com um prefixo "fc". Para criar um atributo que declare um namespace padrão, você cria um atributo com o nome "xmlns", sem um namespace. O valor do atributo é o URI padrão do namespace.
// 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);
Este exemplo gera a seguinte saída:
<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>
O exemplo a seguir cria um documento que contém dois namespaces, ambos com prefixos de namespace.
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);
Este exemplo gera a seguinte saída:
<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>
Outra maneira de obter o mesmo resultado é usar nomes expandidos, em vez de declarar e criar um objeto XNamespace.
Essa abordagem tem implicações de desempenho. Cada vez que você passa uma cadeia de caracteres que contém um nome expandido para o LINQ to XML, o LINQ to XML deve analisar o nome, localizar o namespace atomizado e localizar o nome atomizado. Esse processo utiliza tempo de CPU. Se o desempenho for importante, convém declarar e usar um objeto XNamespace explicitamente.
Se o desempenho for um problema importante, consulte A atomização anterior de XName objetos (LINQ te o XML) para obter mais informações
// 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);
Este exemplo gera a seguinte saída:
<aw:Root xmlns:aw="https://www.adventure-works.com">
<aw:Child>child content</aw:Child>
</aw:Root>