classe System.Xml.XmlTextWriter

A XmlTextWriter classe implementa a XmlWriter classe.

XmlTextWriter Mantém uma pilha de namespaces correspondente a todos os namespaces definidos na pilha de elementos atual. Usando XmlTextWriter você pode declarar namespaces manualmente.

w.WriteStartElement("root");
w.WriteAttributeString("xmlns", "x", null, "urn:1");
w.WriteStartElement("item","urn:1");
w.WriteEndElement();
w.WriteStartElement("item","urn:1");
w.WriteEndElement();
w.WriteEndElement();

O código C# acima produz a seguinte saída. XmlTextWriter Promove a declaração de namespace para o elemento raiz para evitar que ela seja duplicada nos dois elementos filho. Os elementos filho adotam o prefixo da declaração de namespaces.

<root xmlns:x="urn:1">
<x:item/>
<x:item/>
</x:root>

XmlTextWriter também permite que você substitua a declaração de namespace atual. No exemplo a seguir, o URI do namespace "123" é substituído por "abc" para produzir o elemento <x:node xmlns:x="abc"/>XML.

w.WriteStartElement("x","node","123");
w.WriteAttributeString("xmlns","x",null,"abc");

Usando os métodos de gravação que usam um prefixo como um argumento, você também pode especificar qual prefixo usar. No exemplo a seguir, dois prefixos diferentes são mapeados para o mesmo URI de namespace para produzir o texto <x:root xmlns:x="urn:1"><y:item xmlns:y="urn:1"/></x:root>XML.

XmlTextWriter w = new XmlTextWriter(Console.Out);
w.WriteStartElement("x","root","urn:1");
w.WriteStartElement("y","item","urn:1");
w.WriteEndElement();
w.WriteEndElement();
w.Close();

Se houver várias declarações de namespace mapeando prefixos diferentes para o mesmo URI de namespace, XmlTextWriter percorre a pilha de declarações de namespace para trás e seleciona a mais próxima.

XmlTextWriter w = new XmlTextWriter(Console.Out);
w.Formatting = Formatting.Indented;
w.WriteStartElement("x","root","urn:1");
w.WriteStartElement("y","item","urn:1");
w.WriteAttributeString("attr","urn:1","123");
w.WriteEndElement();
w.WriteEndElement();
w.Close();

No exemplo C# acima, como a WriteAttributeString chamada não especifica um prefixo, o escritor usa o último prefixo adicionado à pilha de namespaces e produz o seguinte XML:

<x:root xmlns:x="urn:1">
<y:item y:attr="123" xmlns:y="urn:1" />
</x:root>

Se ocorrerem conflitos de namespace, XmlTextWriter resolva-os gerando prefixos alternativos. Por exemplo, se um atributo e um elemento tiverem o mesmo prefixo, mas namespaces diferentes, XmlWriter gerará um prefixo alternativo para o atributo. Os prefixos gerados são nomeados n{i} onde i é um número que começa em 1. O número é redefinido para 1 para cada elemento.

Os atributos associados a um URI de namespace devem ter um prefixo (namespaces padrão não se aplicam a atributos). Isso está em conformidade com a seção 5.2 da recomendação W3C Namespaces in XML. Se um atributo fizer referência a um URI de namespace, mas não especificar um prefixo, o gravador gerará um prefixo para o atributo.

Ao escrever um elemento vazio, um espaço adicional é adicionado entre o nome da tag e a tag de fechamento, por exemplo <item />. Isso fornece compatibilidade com navegadores mais antigos.

Quando String é usado como parâmetro de método, null e String.Empty são equivalentes. String.Empty segue as regras do W3C.

Para gravar dados fortemente tipados, use a classe XmlConvert para converter tipos de dados para cadeia de caracteres. Por exemplo, o código C# a seguir converte os dados de Double para String e grava o elemento <price>19.95</price>.

Double price = 19.95;
writer.WriteElementString("price", XmlConvert.ToString(price));

XmlTextWriter não verifica o seguinte:

• Caracteres inválidos em nomes de atributos e elementos.
• Caracteres Unicode que não se ajustam à codificação especificada. Se os caracteres Unicode não se ajustarem à codificação especificada, o XmlTextWriter não converterá os caracteres Unicode em entidades de caracteres.
• Atributos duplicados.
• Caracteres presentes no identificador público DOCTYPE ou no identificador de sistema.

Considerações de segurança

Os itens a seguir são coisas a considerar ao trabalhar com a XmlTextWriter classe.

• As exceções lançadas pelo XmlTextWriter podem divulgar informações de caminho que o utilizador não deseja que sejam reveladas ao aplicativo. Seus aplicativos devem detetar exceções e processá-las adequadamente.

• Quando se passa o XmlTextWriter para outra aplicação, o fluxo subjacente é exposto a essa aplicação. Se você precisar passar o XmlTextWriter para um aplicativo semiconfiável, você deve usar um XmlWriter objeto criado pelo Create método em vez disso.

• O XmlTextWriter não valida quaisquer dados que são passados para os WriteDocType métodos ou WriteRaw . Você não deve passar dados arbitrários para esses métodos.

• Se as configurações padrão forem alteradas, não há garantia de que a saída gerada seja de dados XML bem formados.

• Não aceite componentes de suporte, como um Encoding objeto, de uma fonte não confiável.