XNode.CreateReader Método

Definição

Cria um XmlReader para este nó.

Sobrecargas

CreateReader()

Cria um XmlReader para este nó.

CreateReader(ReaderOptions)

Cria um XmlReader com as opções especificadas pelo parâmetro readerOptions.

CreateReader()

Cria um XmlReader para este nó.

public System.Xml.XmlReader CreateReader ();

Retornos

XmlReader

Um XmlReader que pode ser usado para ler esse nó e seus descendentes.

Exemplos

O exemplo a seguir cria uma árvore XML, cria uma XmlReader usando o CreateReader método e cria uma XmlDocument usando o leitor.

XDocument xmlTree = new XDocument(  
    new XElement("Root",  
        new XAttribute("Att1", "Attribute Content"),  
        new XElement("Child1", 1),  
        new XElement("Child2", 2)  
    )  
);  
XmlReader reader = xmlTree.CreateReader();  
reader.MoveToContent();  
XmlDocument doc = new XmlDocument();  
XmlNode cd = doc.ReadNode(reader);  
doc.AppendChild(cd);  
Console.WriteLine(doc.OuterXml);  

Esse exemplo gera a saída a seguir:

<Root Att1="Attribute Content"><Child1>1</Child1><Child2>2</Child2></Root>  

Outro uso para esse método é fazer uma transformação XSLT. Você pode criar uma árvore XML, criar um XmlReader na árvore XML, criar um novo documento e criar um XmlWriter que gravarão no novo documento. Em seguida, você pode chamar a transformação XSLT, passando XmlReader e XmlWriter para a transformação. Depois que a transformação for concluída com êxito, a nova árvore XML será populada com os resultados da transformação.

string xslMarkup = @"<?xml version='1.0'?>  
<xsl:stylesheet xmlns:xsl='http://www.w3.org/1999/XSL/Transform' version='1.0'>  
    <xsl:template match='/Parent'>  
        <Root>  
            <C1>  
            <xsl:value-of select='Child1'/>  
            </C1>  
            <C2>  
            <xsl:value-of select='Child2'/>  
            </C2>  
        </Root>  
    </xsl:template>  
</xsl:stylesheet>";  

XDocument xmlTree = new XDocument(  
    new XElement("Parent",  
        new XElement("Child1", "Child1 data"),  
        new XElement("Child2", "Child2 data")  
    )  
);  

XDocument newTree = new XDocument();  
using (XmlWriter writer = newTree.CreateWriter()) {  
    // Load the style sheet.  
    XslCompiledTransform xslt = new XslCompiledTransform();  
    xslt.Load(XmlReader.Create(new StringReader(xslMarkup)));  

    // Execute the transform and output the results to a writer.  
    xslt.Transform(xmlTree.CreateReader(), writer);  
}  

Console.WriteLine(newTree);  

Esse exemplo gera a saída a seguir:

<Root>  
  <C1>Child1 data</C1>  
  <C2>Child2 data</C2>  
</Root>  

Comentários

Normalmente, você usa esse método quando precisa fornecer outro componente com um XmlReader. Por exemplo, você pode criar uma XmlReader árvore de LINQ to XML e, em seguida, passar esse leitor para Load.

Todos os leitores retornados estão Create normalizando os leitores. Eles sempre executam a normalização de quebra de linha e a normalização completa dos atributos. Por outro lado, o XmlReader retornado por CreateReader não é um leitor normalizador. Ele não transforma nenhum espaço em branco. Ele também retorna atributos na ordem em que foram adicionados, não na ordem de nome do atributo.

LINQ to XML não mantém informações sobre se os atributos são atributos padrão. IsDefault sempre retornará false, independentemente de o atributo ter sido preenchido de um valor padrão ou não.

Os PUBLIC atributos XDocumentType e SYSTEM pseudo não estão disponíveis por meio do XmlReader.MoveToAttribute método. Elas só estão disponíveis por meio do XmlReader.GetAttribute método que usa o nome qualificado do atributo como um parâmetro. Se você precisar recuperar os atributos ou SYSTEM os PUBLIC atributos, deverá usar o XmlReader.GetAttribute método.

Não há suporte para dados Base64 e BinHex. Se você tentar recuperar esses tipos de dados (por exemplo, chamando ReadElementContentAsBase64), o leitor gerará NotSupportedException.

A xml declaração não é exibida pelo leitor. Durante a leitura, você não encontrará um nó do tipo XmlDeclaration.

Confira também

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

CreateReader(ReaderOptions)

Cria um XmlReader com as opções especificadas pelo parâmetro readerOptions.

public System.Xml.XmlReader CreateReader (System.Xml.Linq.ReaderOptions readerOptions);

Parâmetros

readerOptions
ReaderOptions

Um objeto ReaderOptions que especifica se os namespaces duplicados devem ser omitidos.

Retornos

XmlReader

Um objeto XmlReader.

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0