XNode.CreateReader 方法

定义

命名空间:

System.Xml.Linq

程序集:

System.Xml.XDocument.dll

程序集:

System.Xml.Linq.dll

程序集:

netstandard.dll

创建此节点的 XmlReader。

重载

CreateReader()	创建此节点的 XmlReader。
CreateReader(ReaderOptions)	使用 readerOptions 参数指定的选项创建 XmlReader。

CreateReader()

创建此节点的 XmlReader。

public:
 System::Xml::XmlReader ^ CreateReader();

public System.Xml.XmlReader CreateReader ();

member this.CreateReader : unit -> System.Xml.XmlReader

Public Function CreateReader () As XmlReader

返回

XmlReader

可用于读取此节点及其子代的 XmlReader。

示例

以下示例创建 XML 树，使用CreateReader该方法创建一个 XmlReader XML 树，并使用读取器创建一个XmlDocument。

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);  

Dim xmlTree As XDocument =  _   
    <?xml version="1.0" encoding="utf-8" standalone="yes"?>  
        <Root Att1="Attribute Content">  
            <Child1>1</Child1>  
            <Child2>2</Child2>  
        </Root>  
Dim reader As XmlReader = xmlTree.CreateReader()  
reader.MoveToContent()  
Dim doc As XmlDocument = New XmlDocument()  
Dim cd As XmlNode = doc.ReadNode(reader)  
doc.AppendChild(cd)  
Console.WriteLine(doc.OuterXml)  

该示例产生下面的输出：

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

此方法的另一个用途是执行 XSLT 转换。 可以创建 XML 树，从 XML 树创建 XmlReader，创建新文档，然后创建 XmlWriter，以写入新文档。 然后，您可以调用 XSLT 转换，并可以将 XmlReader 和 XmlWriter 传递到转换中。 在转换成功完成后，使用转换的结果，填充新的 XML 树。

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);  

Dim xslMarkup As XDocument = _   
    <?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>  

Dim xmlTree As XElement = _   
        <Parent>  
            <Child1>Child1 data</Child1>  
            <Child2>Child2 data</Child2>  
        </Parent>  

Dim newTree As XDocument = New XDocument()  

Using writer As XmlWriter = newTree.CreateWriter()  
    ' Load the style sheet.  
    Dim xslt As XslCompiledTransform = _  
        New XslCompiledTransform()  
    xslt.Load(xslMarkup.CreateReader())  

    ' Execute the transform and output the results to a writer.  
    xslt.Transform(xmlTree.CreateReader(), writer)  
End Using  

Console.WriteLine(newTree)  

该示例产生下面的输出：

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

注解

当必须向另一个组件提供另一个 XmlReader组件时，通常使用此方法。 例如，可以从LINQ to XML树创建一个XmlReader，然后将该读取器Load传递给 。

返回的所有读取器都是规范化读取 Create 器。 它们始终执行换行规范化和属性的完整规范化。 相比之下， XmlReader 返回的 CreateReader 读取器不是规范化读取器。 它不会转换任何空白。 它还按添加的顺序返回属性，而不是按属性名称顺序返回属性。

LINQ to XML不保留有关属性是否为默认属性的信息。 IsDefault 无论属性是否从默认值填充，都将始终返回 false。

方法不提供 XmlReader.MoveToAttribute on XDocumentType 的PUBLIC``SYSTEM伪属性。 它们只能通过采用属性的限定名称作为参数的方法使用 XmlReader.GetAttribute 。 如果必须检索 PUBLIC 或 SYSTEM 属性，则应使用 XmlReader.GetAttribute 该方法。

不支持 Base64 和 BinHex 数据。 例如，如果尝试通过调用 ReadElementContentAsBase64 () 来检索这些类型的数据，则读取器将引发 NotSupportedException。

读取 xml 器不会显示声明。 读取时，不会遇到一个类型为 XmlDeclaration节点的节点。

另请参阅

• LINQ to XML 概述

CreateReader(ReaderOptions)

使用 readerOptions 参数指定的选项创建 XmlReader。

public:
 System::Xml::XmlReader ^ CreateReader(System::Xml::Linq::ReaderOptions readerOptions);

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

member this.CreateReader : System.Xml.Linq.ReaderOptions -> System.Xml.XmlReader

Public Function CreateReader (readerOptions As ReaderOptions) As XmlReader

参数

readerOptions

ReaderOptions

指定是否省略重复的命名空间的 ReaderOptions 对象。

返回

XmlReader

一个 XmlReader 对象。