XNode.CreateReader メソッド

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 ツリーを作成し、メソッドを使用して an XmlReader を CreateReader 作成し、リーダーを使用して作成 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>  

このメソッドのもう 1 つの用途は、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 を返します。

SYSTEMメソッドPUBLICでは、擬似属性と擬似XDocumentType属性はXmlReader.MoveToAttribute使用できません。 これらは、属性の修飾名を XmlReader.GetAttribute パラメーターとして受け取るメソッドでのみ使用できます。 またはSYSTEM属性を取得PUBLICする必要がある場合は、メソッドを使用するXmlReader.GetAttribute必要があります。

Base64 データと BinHex データはサポートされていません。 (たとえば、呼び出し ReadElementContentAsBase64によって) これらの種類のデータを取得しようとすると、リーダーがスロー NotSupportedExceptionします。

xml宣言はリーダーによって表示されません。 読んでいる間、あなたはタイプ XmlDeclarationのノードに遭遇しません.

こちらもご覧ください

• LINQ to XML の概要

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

パラメーター

戻り値

XmlReader

XmlReader オブジェクト。