XDocument Osztály

Definíció

Névtér:

System.Xml.Linq

Szerelvények:

netstandard.dll, System.Xml.XDocument.dll

Forrás:

XDocument.cs

XML-dokumentumot jelöl. Az objektumok összetevőiről és használatáról XDocument az XDocument Osztály áttekintése című témakörben olvashat.

public ref class XDocument : System::Xml::Linq::XContainer

public class XDocument : System.Xml.Linq.XContainer

type XDocument = class
    inherit XContainer

Public Class XDocument
Inherits XContainer

Öröklődés

Object

XObject

XNode

XContainer

XDocument

Példák

Az alábbi példa létrehoz egy dokumentumot, majd hozzáad hozzá egy megjegyzést és egy elemet. Ezután egy lekérdezés eredményeivel egy másik dokumentumot ír össze.

XDocument srcTree = new XDocument(
    new XComment("This is a comment"),
    new XElement("Root",
        new XElement("Child1", "data1"),
        new XElement("Child2", "data2"),
        new XElement("Child3", "data3"),
        new XElement("Child2", "data4"),
        new XElement("Info5", "info5"),
        new XElement("Info6", "info6"),
        new XElement("Info7", "info7"),
        new XElement("Info8", "info8")
    )
);

XDocument doc = new XDocument(
    new XComment("This is a comment"),
    new XElement("Root",
        from el in srcTree.Element("Root").Elements()
        where ((string)el).StartsWith("data")
        select el
    )
);
Console.WriteLine(doc);

Dim srcTree As XDocument = _
    <?xml version="1.0" encoding="utf-8" standalone="yes"?>
        <!--This is a comment-->
        <Root>
            <Child1>data1</Child1>
            <Child2>data2</Child2>
            <Child3>data3</Child3>
            <Child2>data4</Child2>
            <Info5>info5</Info5>
            <Info6>info6</Info6>
            <Info7>info7</Info7>
            <Info8>info8</Info8>
        </Root>
Dim doc As XDocument = _
    <?xml version="1.0" encoding="utf-8" standalone="yes"?>
        <!--This is a comment-->
        <Root>
            <%= From el In srcTree.<Root>.Elements _
                Where CStr(el).StartsWith("data") _
                Select el %>
        </Root>
Console.WriteLine(doc)

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

<!--This is a comment-->
<Root>
  <Child1>data1</Child1>
  <Child2>data2</Child2>
  <Child3>data3</Child3>
  <Child2>data4</Child2>
</Root>

Megjegyzések

Az egyes XDocumentobjektumok érvényes tartalmával kapcsolatos részletekért lásd az XElement és az XDocument Objektumok érvényes tartalmát.

Konstruktorok

Name	Description
XDocument()	Inicializálja a XDocument osztály új példányát.
XDocument(Object[])	Inicializálja az osztály új példányát XDocument a megadott tartalommal.
XDocument(XDeclaration, Object[])	Inicializálja az osztály új példányát XDocument a megadott XDeclaration és a tartalommal.
XDocument(XDocument)	Inicializálja az XDocument osztály új példányát egy meglévő XDocument objektumból.

Tulajdonságok

Name	Description
BaseUri	Lekéri ehhez az alap URI-t XObject. (Öröklődés forrása XObject)
Declaration	Lekéri vagy beállítja a dokumentum XML-deklarációját.
Document	Megkapja ezt XDocumenta XObject . (Öröklődés forrása XObject)
DocumentType	Lekéri a dokumentum dokumentumtípus-definícióját (DTD).
FirstNode	Lekéri a csomópont első gyermekcsomópontját. (Öröklődés forrása XContainer)
LastNode	Lekéri a csomópont utolsó gyermekcsomópontját. (Öröklődés forrása XContainer)
NextNode	Lekéri a csomópont következő testvércsomópontját. (Öröklődés forrása XNode)
NodeType	Lekéri a csomópont csomóponttípusát.
Parent	Lekéri ennek XElementa szülőjének a szülőjeXObject. (Öröklődés forrása XObject)
PreviousNode	Lekéri a csomópont előző testvércsomópontját. (Öröklődés forrása XNode)
Root	Lekéri a dokumentum XML-fájának gyökérelemét.

Metódusok

Name	Description
Add(Object)	Hozzáadja a megadott tartalmat ennek a XContainergyermekként. (Öröklődés forrása XContainer)
Add(Object[])	Hozzáadja a megadott tartalmat ennek a XContainergyermekként. (Öröklődés forrása XContainer)
AddAfterSelf(Object)	A megadott tartalmat közvetlenül a csomópont után adja hozzá. (Öröklődés forrása XNode)
AddAfterSelf(Object[])	A megadott tartalmat közvetlenül a csomópont után adja hozzá. (Öröklődés forrása XNode)
AddAnnotation(Object)	Objektumot ad hozzá a jegyzetlistához.XObject (Öröklődés forrása XObject)
AddBeforeSelf(Object)	Közvetlenül a csomópont előtt adja hozzá a megadott tartalmat. (Öröklődés forrása XNode)
AddBeforeSelf(Object[])	Közvetlenül a csomópont előtt adja hozzá a megadott tartalmat. (Öröklődés forrása XNode)
AddFirst(Object)	A dokumentum vagy elem első gyermekeként adja hozzá a megadott tartalmat. (Öröklődés forrása XContainer)
AddFirst(Object[])	A dokumentum vagy elem első gyermekeként adja hozzá a megadott tartalmat. (Öröklődés forrása XContainer)
Ancestors()	A csomópont elődelemeinek gyűjteményét adja vissza. (Öröklődés forrása XNode)
Ancestors(XName)	A csomópont őselemeinek szűrt gyűjteményét adja vissza. A gyűjtemény csak az egyező XName elemeket tartalmazza. (Öröklődés forrása XNode)
Annotation(Type)	A megadott típus első széljegyzetobjektumának lekérdezése ebből XObjecta helyről. (Öröklődés forrása XObject)
Annotation<T>()	A megadott típus első széljegyzetobjektumának lekérdezése ebből XObjecta helyről. (Öröklődés forrása XObject)
Annotations(Type)	Lekéri a megadott típusú széljegyzetek gyűjteményét.XObject (Öröklődés forrása XObject)
Annotations<T>()	Lekéri a megadott típusú széljegyzetek gyűjteményét.XObject (Öröklődés forrása XObject)
CreateReader()	Létrehoz egy csomópontot XmlReader . (Öröklődés forrása XNode)
CreateReader(ReaderOptions)	Létrehoz egy, XmlReader a paraméter által readerOptions megadott beállításokat. (Öröklődés forrása XNode)
CreateWriter()	Létrehoz egy olyan csomópontot XmlWriter , amellyel csomópontokat adhat hozzá a XContainer. (Öröklődés forrása XContainer)
DescendantNodes()	A dokumentum vagy elem leszármazott csomópontjainak gyűjteményét adja vissza dokumentumsorrendben. (Öröklődés forrása XContainer)
Descendants()	A dokumentum vagy elem leszármazott elemeinek gyűjteményét adja vissza dokumentumsorrendben. (Öröklődés forrása XContainer)
Descendants(XName)	A dokumentum vagy elem leszármazott elemeinek szűrt gyűjteményét adja vissza dokumentumsorrendben. A gyűjtemény csak az egyező XName elemeket tartalmazza. (Öröklődés forrása XContainer)
Element(XName)	Lekéri az első (dokumentum szerinti) gyermekelemet a megadott XName. (Öröklődés forrása XContainer)
Elements()	Az elem vagy dokumentum gyermekelemeinek gyűjteményét adja vissza dokumentumsorrendben. (Öröklődés forrása XContainer)
Elements(XName)	Az elem vagy dokumentum gyermekelemeinek szűrt gyűjteményét adja vissza dokumentumsorrendben. A gyűjtemény csak az egyező XName elemeket tartalmazza. (Öröklődés forrása XContainer)
ElementsAfterSelf()	A csomópont utáni testvérelemek gyűjteményét adja vissza dokumentumsorrendben. (Öröklődés forrása XNode)
ElementsAfterSelf(XName)	A csomópont után a testvérelemek szűrt gyűjteményét adja vissza dokumentumsorrendben. A gyűjtemény csak az egyező XName elemeket tartalmazza. (Öröklődés forrása XNode)
ElementsBeforeSelf()	A csomópont előtti testvérelemek gyűjteményét adja vissza dokumentumsorrendben. (Öröklődés forrása XNode)
ElementsBeforeSelf(XName)	A csomópont előtti testvérelemek szűrt gyűjteményét adja vissza dokumentumsorrendben. A gyűjtemény csak az egyező XName elemeket tartalmazza. (Öröklődés forrása XNode)
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IsAfter(XNode)	Meghatározza, hogy az aktuális csomópont egy adott csomópont után jelenik-e meg a dokumentumrend szempontjából. (Öröklődés forrása XNode)
IsBefore(XNode)	Meghatározza, hogy az aktuális csomópont megjelenik-e egy adott csomópont előtt a dokumentumrend szempontjából. (Öröklődés forrása XNode)
Load(Stream, LoadOptions)	Létrehoz egy új XDocument példányt a megadott stream használatával, opcionálisan megőrizve a szabad területet, beállítja az alap URI-t, és megőrzi a sorinformációkat.
Load(Stream)	Új példányt XDocument hoz létre a megadott stream használatával.
Load(String, LoadOptions)	Létrehoz egy új XDocument fájlt egy fájlból, opcionálisan megőrzi a szabad területet, beállítja az alap URI-t, és megőrzi a sorinformációkat.
Load(String)	Újat XDocument hoz létre egy fájlból.
Load(TextReader, LoadOptions)	Létrehoz egy újat XDocument egy TextReader, opcionálisan a szabad terület megőrzésével, az alap URI beállításával és a vonaladatok megőrzésével.
Load(TextReader)	Újat XDocument hoz létre egy TextReader.
Load(XmlReader, LoadOptions)	Betölt egy XDocument uri-t egyből XmlReader, opcionálisan beállítja az alap URI-t, és megtartja a sorinformációkat.
Load(XmlReader)	Újat hoz létre egy XDocumentXmlReader.
LoadAsync(Stream, LoadOptions, CancellationToken)	Aszinkron módon létrehoz egy újat XDocument , és inicializálja a mögöttes XML-fát a megadott streamből, opcionálisan megőrizve a szabad helyet.
LoadAsync(TextReader, LoadOptions, CancellationToken)	Létrehoz egy újat XDocument , és inicializálja a mögöttes XML-fát a megadott TextReader paraméterrel, opcionálisan megőrizve a szabad területet.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Létrehoz egy újat XDocument , amely a megadott XmlReadertartalommal rendelkezik.
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
Nodes()	Az elem vagy dokumentum gyermekcsomópontjainak gyűjteményét adja vissza dokumentumsorrendben. (Öröklődés forrása XContainer)
NodesAfterSelf()	A testvércsomópontok gyűjteményét adja vissza a csomópont után, dokumentumsorrendben. (Öröklődés forrása XNode)
NodesBeforeSelf()	A csomópont előtti testvércsomópontok gyűjteményét adja vissza dokumentumsorrendben. (Öröklődés forrása XNode)
Parse(String, LoadOptions)	Létrehoz egy újat XDocument egy sztringből, opcionálisan megőrzi a szabad területet, beállítja az alap URI-t, és megőrzi a sorinformációkat.
Parse(String)	Újat XDocument hoz létre egy sztringből.
Remove()	Eltávolítja ezt a csomópontot a szülőből. (Öröklődés forrása XNode)
RemoveAnnotations(Type)	Eltávolítja a megadott típusú széljegyzeteket ebből a XObjecthelyről. (Öröklődés forrása XObject)
RemoveAnnotations<T>()	Eltávolítja a megadott típusú széljegyzeteket ebből a XObjecthelyről. (Öröklődés forrása XObject)
RemoveNodes()	Eltávolítja a gyermekcsomópontokat ebből a dokumentumból vagy elemből. (Öröklődés forrása XContainer)
ReplaceNodes(Object)	A dokumentum vagy elem gyermekcsomópontjait lecseréli a megadott tartalomra. (Öröklődés forrása XContainer)
ReplaceNodes(Object[])	A dokumentum vagy elem gyermekcsomópontjait lecseréli a megadott tartalomra. (Öröklődés forrása XContainer)
ReplaceWith(Object)	Ezt a csomópontot lecseréli a megadott tartalomra. (Öröklődés forrása XNode)
ReplaceWith(Object[])	Ezt a csomópontot lecseréli a megadott tartalomra. (Öröklődés forrása XNode)
Save(Stream, SaveOptions)	Ezt XDocument a megadott Stream, opcionálisan a formázási viselkedést megadva adja meg.
Save(Stream)	Ezt XDocument a megadott Streamértékre adja ki.
Save(String, SaveOptions)	Szerializálja ezt XDocument egy fájlba, opcionálisan letiltva a formázást.
Save(String)	Szerializálja ezt XDocument egy fájlba, felülírva egy meglévő fájlt, ha létezik.
Save(TextWriter, SaveOptions)	Szerializálja ezt XDocument egy TextWriter, opcionálisan letiltó formázásra.
Save(TextWriter)	Szerializálja ezt XDocument egy TextWriter.
Save(XmlWriter)	Szerializálja ezt XDocument egy XmlWriter.
SaveAsync(Stream, SaveOptions, CancellationToken)	XDocument Ezt a kimenetet adja meg egy Stream.
SaveAsync(TextWriter, SaveOptions, CancellationToken)	Ezt XDocument írja egy TextWriter.
SaveAsync(XmlWriter, CancellationToken)	Ezt XDocument írja egy XmlWriter.
ToString()	A csomópont behúzásos XML-értékét adja vissza. (Öröklődés forrása XNode)
ToString(SaveOptions)	Ennek a csomópontnak az XML-ét adja vissza, opcionálisan letiltva a formázást. (Öröklődés forrása XNode)
WriteTo(XmlWriter)	Írja ezt a dokumentumot egy XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)	Az XDocument mögöttes XML-fáját a megadott XmlWriterértékre írja.

esemény

Name	Description
Changed	Akkor merül fel, amikor ez XObject vagy bármelyik leszármazottja megváltozott. (Öröklődés forrása XObject)
Changing	Akkor merül fel, amikor ez XObject vagy bármelyik leszármazottja megváltozik. (Öröklődés forrása XObject)

Explicit interfész-implementációk

Name	Description
IXmlLineInfo.HasLineInfo()	Beolvas egy értéket, amely jelzi, hogy ez XObject tartalmaz-e sorinformációkat. (Öröklődés forrása XObject)
IXmlLineInfo.LineNumber	Lekéri a mögöttes jelentéshez XmlReader tartozó sorszámot.XObject (Öröklődés forrása XObject)
IXmlLineInfo.LinePosition	Lekéri a mögöttes jelentéshez XmlReader tartozó vonalpozíciót XObject. (Öröklődés forrása XObject)

Bővítő metódusok

Name	Description
CreateNavigator(XNode, XmlNameTable)	Létrehoz egy XPathNavigatorXNode. Ez XmlNameTable hatékonyabb XPath-kifejezésfeldolgozást tesz lehetővé.
CreateNavigator(XNode)	Létrehoz egy XPathNavigatorXNode.
ToXPathNavigable(XNode)	Egy olyan tartozékot ad vissza, amely lehetővé teszi a megadott XNodeelem navigálását és szerkesztését.
Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)	Ellenőrzi, hogy egy XDocument XSD-nek megfelel-e az XmlSchemaSetXML-fa, opcionálisan feltöltve a séma utáni érvényesítési adatkészlettel (PSVI).
Validate(XDocument, XmlSchemaSet, ValidationEventHandler)	Ez a metódus ellenőrzi, hogy egy XDocument XSD-nek felel-e meg egy XmlSchemaSet.
XPathEvaluate(XNode, String, IXmlNamespaceResolver)	Kiértékel egy XPath-kifejezést, és feloldja a névtér előtagjait a megadott IXmlNamespaceResolverhasználatával.
XPathEvaluate(XNode, String)	Kiértékel egy XPath-kifejezést.
XPathSelectElement(XNode, String, IXmlNamespaceResolver)	Kiválaszt egy XElement XPath-kifejezést, amely feloldja a névtér előtagjait a megadott IXmlNamespaceResolverhasználatával.
XPathSelectElement(XNode, String)	Kiválaszt egy XElement XPath-kifejezést.
XPathSelectElements(XNode, String, IXmlNamespaceResolver)	Kiválaszt egy elemgyűjteményt egy XPath-kifejezéssel, és feloldja a névtér előtagjait a megadott IXmlNamespaceResolverparanccsel.
XPathSelectElements(XNode, String)	Elemek gyűjteményét választja ki egy XPath-kifejezés használatával.

Lásd még

• XNamespace
• XDeclaration
• XElement
• XNode
• LINQ–XML – áttekintés
• Az XDocument-osztály áttekintése