XNode.CreateReader Metódus

Definíció

Névtér:

System.Xml.Linq

Szerelvények:

netstandard.dll, System.Xml.XDocument.dll

Létrehoz egy csomópontot XmlReader .

Túlterhelések

Name	Description
CreateReader()	Létrehoz egy csomópontot XmlReader .
CreateReader(ReaderOptions)	Létrehoz egy, XmlReader a paraméter által readerOptions megadott beállításokat.

CreateReader()

Forrás:

XNode.cs

Létrehoz egy csomópontot XmlReader .

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

public System.Xml.XmlReader CreateReader();

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

Public Function CreateReader () As XmlReader

Válaszok

XmlReader

A XmlReader csomópont és leszármazottai olvasására használható.

Példák

Az alábbi példa létrehoz egy XML-fát, létrehoz egy XmlReader metódust CreateReader , és létrehoz egy XmlDocument fájlt az olvasó használatával.

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)

Ez a példa a következő kimenetet hozza létre:

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

Ennek a módszernek egy másik módja az XSLT-átalakítás végrehajtása. Létrehozhat egy XML-fát, létrehozhat egy XmlReader XML-fát, létrehozhat egy új dokumentumot, és létrehozhat egy XmlWriter olyan fájlt, amely az új dokumentumba fog írni. Ezután meghívhatja az XSLT-átalakítást, átadva az XmlReader átalakításnak és XmlWriter az átalakításnak. Az átalakítás sikeres befejezése után az új XML-fa fel lesz töltve az átalakítás eredményeivel.

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)

Ez a példa a következő kimenetet hozza létre:

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

Megjegyzések

Ezt a módszert általában akkor használja, ha egy másik összetevőt kell megadnia egy XmlReader. Létrehozhat például egy XmlReader LINQ-ból XML-fát, majd átadhatja az olvasónak Load.

Az összes visszaadott Create olvasó normalizálja az olvasókat. Mindig sortörés normalizálását és az attribútumok teljes normalizálását hajtják végre. Ezzel szemben a XmlReader visszaadott CreateReader érték nem normalizáló olvasó. Nem alakít át üres területet. Az attribútumokat a hozzáadás sorrendjében adja vissza, nem pedig az attribútumok névsorrendjében.

A LINQ-ből XML-be nem tart adatokat arról, hogy az attribútumok alapértelmezett attribútumok-e. IsDefault A függvény mindig hamis értéket ad vissza, függetlenül attól, hogy az attribútum egy alapértelmezett értékből lett-e feltöltve.

Az PUBLIC és SYSTEM a XDocumentType pszeudo attribútumok nem érhetők el a XmlReader.MoveToAttribute metóduson keresztül. Ezek csak azon a XmlReader.GetAttribute metóduson keresztül érhetők el, amely paraméterként az attribútum minősített nevét veszi fel. Ha le kell kérnie az PUBLIC attribútumokat, SYSTEM használja a metódust XmlReader.GetAttribute .

A Base64- és BinHex-adatok nem támogatottak. Ha ilyen típusú adatokat próbál lekérni (például hívással ReadElementContentAsBase64), az olvasó dobni NotSupportedExceptionfog.

A xml deklarációt az olvasó nem iktatja fel. Olvasás közben nem fog találkozni típusú csomópontokkal XmlDeclaration.

Lásd még

• LINQ–XML – áttekintés

CreateReader(ReaderOptions)

Forrás:

XNode.cs

Létrehoz egy, XmlReader a paraméter által readerOptions megadott beállításokat.

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

Paraméterek

readerOptions

ReaderOptions

Egy ReaderOptions objektum, amely meghatározza, hogy kihagyja-e az ismétlődő névtereket.

Válaszok

XmlReader

Egy XmlReader objektum.