XDocument Třída

Definice

Obor názvů:

System.Xml.Linq

Sestavení:

netstandard.dll, System.Xml.XDocument.dll

Zdroj:

XDocument.cs

Představuje dokument XML. Informace o komponentách a použití objektu XDocument naleznete v tématu Přehled třídy XDocument.

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

Dědičnost

Object

XObject

XNode

XContainer

XDocument

Příklady

Následující příklad vytvoří dokument a pak do něj přidá komentář a prvek. Potom vytvoří jiný dokument pomocí výsledků dotazu.

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)

Tento příklad vytvoří následující výstup:

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

Poznámky

Podrobnosti o platném obsahu objektu XDocument, naleznete v části Platný obsah XElement a XDocument Objects.

Konstruktory

Name	Description
XDocument()	Inicializuje novou instanci XDocument třídy.
XDocument(Object[])	Inicializuje novou instanci XDocument třídy se zadaným obsahem.
XDocument(XDeclaration, Object[])	Inicializuje novou instanci XDocument třídy se zadaným XDeclaration a obsahem.
XDocument(XDocument)	Inicializuje novou instanci XDocument třídy z existujícího XDocument objektu.

Vlastnosti

Name	Description
BaseUri	Získá základní identifikátor URI pro tento XObject. (Zděděno od XObject)
Declaration	Získá nebo nastaví deklaraci XML pro tento dokument.
Document	XDocument Získá pro to XObject. (Zděděno od XObject)
DocumentType	Získá definici typu dokumentu (DTD) pro tento dokument.
FirstNode	Získá první podřízený uzel tohoto uzlu. (Zděděno od XContainer)
LastNode	Získá poslední podřízený uzel tohoto uzlu. (Zděděno od XContainer)
NextNode	Získá další uzel na stejné úrovni tohoto uzlu. (Zděděno od XNode)
NodeType	Získá typ uzlu pro tento uzel.
Parent	Získá nadřazený XElement objekt tohoto XObject. (Zděděno od XObject)
PreviousNode	Získá předchozí uzel na stejné úrovni tohoto uzlu. (Zděděno od XNode)
Root	Získá kořenový prvek stromu XML pro tento dokument.

Metody

Name	Description
Add(Object)	Přidá zadaný obsah jako podřízené položky XContainertohoto souboru . (Zděděno od XContainer)
Add(Object[])	Přidá zadaný obsah jako podřízené položky XContainertohoto souboru . (Zděděno od XContainer)
AddAfterSelf(Object)	Přidá zadaný obsah bezprostředně za tímto uzlem. (Zděděno od XNode)
AddAfterSelf(Object[])	Přidá zadaný obsah bezprostředně za tímto uzlem. (Zděděno od XNode)
AddAnnotation(Object)	Přidá objekt do seznamu poznámek tohoto XObjectobjektu . (Zděděno od XObject)
AddBeforeSelf(Object)	Přidá zadaný obsah bezprostředně před tento uzel. (Zděděno od XNode)
AddBeforeSelf(Object[])	Přidá zadaný obsah bezprostředně před tento uzel. (Zděděno od XNode)
AddFirst(Object)	Přidá zadaný obsah jako první podřízené položky tohoto dokumentu nebo elementu. (Zděděno od XContainer)
AddFirst(Object[])	Přidá zadaný obsah jako první podřízené položky tohoto dokumentu nebo elementu. (Zděděno od XContainer)
Ancestors()	Vrátí kolekci nadřazených prvků tohoto uzlu. (Zděděno od XNode)
Ancestors(XName)	Vrátí filtrovanou kolekci nadřazených prvků tohoto uzlu. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající XName. (Zděděno od XNode)
Annotation(Type)	Získá první anotační objekt zadaného typu z tohoto XObject. (Zděděno od XObject)
Annotation<T>()	Získá první anotační objekt zadaného typu z tohoto XObject. (Zděděno od XObject)
Annotations(Type)	Získá kolekci poznámek zadaného typu pro tento XObject. (Zděděno od XObject)
Annotations<T>()	Získá kolekci poznámek zadaného typu pro tento XObject. (Zděděno od XObject)
CreateReader()	Vytvoří pro tento uzel.XmlReader (Zděděno od XNode)
CreateReader(ReaderOptions)	Vytvoří s XmlReader možnostmi zadanými parametrem readerOptions . (Zděděno od XNode)
CreateWriter()	Vytvoří objekt XmlWriter , který lze použít k přidání uzlů do objektu XContainer. (Zděděno od XContainer)
DescendantNodes()	Vrátí kolekci následnických uzlů pro tento dokument nebo prvek v pořadí dokumentů. (Zděděno od XContainer)
Descendants()	Vrátí kolekci následnických prvků pro tento dokument nebo prvek v pořadí dokumentu. (Zděděno od XContainer)
Descendants(XName)	Vrátí filtrovanou kolekci následnických prvků pro tento dokument nebo prvek v pořadí dokumentu. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající XName. (Zděděno od XContainer)
Element(XName)	Získá první (v pořadí dokumentu) podřízený prvek se zadaným XName. (Zděděno od XContainer)
Elements()	Vrátí kolekci podřízených prvků tohoto prvku nebo dokumentu v pořadí dokumentu. (Zděděno od XContainer)
Elements(XName)	Vrátí filtrovanou kolekci podřízených prvků tohoto prvku nebo dokumentu v pořadí dokumentu. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající XName. (Zděděno od XContainer)
ElementsAfterSelf()	Vrátí kolekci prvků na stejné úrovni za tímto uzlem v pořadí dokumentu. (Zděděno od XNode)
ElementsAfterSelf(XName)	Vrátí filtrovanou kolekci prvků na stejné úrovni za tímto uzlem v pořadí dokumentu. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající XName. (Zděděno od XNode)
ElementsBeforeSelf()	Vrátí kolekci prvků na stejné úrovni před tímto uzlem v pořadí dokumentu. (Zděděno od XNode)
ElementsBeforeSelf(XName)	Vrátí filtrovanou kolekci prvků na stejné úrovni před tímto uzlem v pořadí dokumentu. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající XName. (Zděděno od XNode)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
IsAfter(XNode)	Určuje, jestli se aktuální uzel zobrazí za zadaným uzlem z hlediska pořadí dokumentů. (Zděděno od XNode)
IsBefore(XNode)	Určuje, jestli se aktuální uzel zobrazí před zadaným uzlem z hlediska pořadí dokumentů. (Zděděno od XNode)
Load(Stream, LoadOptions)	Vytvoří novou XDocument instanci pomocí zadaného datového proudu, volitelně zachová prázdné znaky, nastaví základní identifikátor URI a zachová informace o řádku.
Load(Stream)	Vytvoří novou XDocument instanci pomocí zadaného datového proudu.
Load(String, LoadOptions)	Vytvoří nový XDocument ze souboru, volitelně zachová prázdné znaky, nastaví základní identifikátor URI a zachová řádkové informace.
Load(String)	Vytvoří nový XDocument ze souboru.
Load(TextReader, LoadOptions)	Vytvoří nový XDocument z volitelného TextReaderzachování prázdných znaků, nastavení základního identifikátoru URI a zachování informací o řádku.
Load(TextReader)	Vytvoří novou XDocument z objektu TextReader.
Load(XmlReader, LoadOptions)	XDocument Načte z objektu XmlReader, volitelně nastaví základní identifikátor URI a zachová informace o řádku.
Load(XmlReader)	Vytvoří novou XDocument z objektu XmlReader.
LoadAsync(Stream, LoadOptions, CancellationToken)	Asynchronně vytvoří nový XDocument a inicializuje základní strom XML ze zadaného datového proudu, volitelně zachová prázdné znaky.
LoadAsync(TextReader, LoadOptions, CancellationToken)	Vytvoří nový XDocument a inicializuje základní strom XML pomocí zadaného TextReader parametru, volitelně zachová prázdné znaky.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Vytvoří nový XDocument obsahující obsah zadaného XmlReader.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
Nodes()	Vrátí kolekci podřízených uzlů tohoto prvku nebo dokumentu v pořadí dokumentu. (Zděděno od XContainer)
NodesAfterSelf()	Vrátí kolekci uzlů na stejné úrovni za tímto uzlem v pořadí dokumentu. (Zděděno od XNode)
NodesBeforeSelf()	Vrátí kolekci uzlů na stejné úrovni před tímto uzlem v pořadí dokumentu. (Zděděno od XNode)
Parse(String, LoadOptions)	Vytvoří nový XDocument z řetězce, volitelně zachová prázdné znaky, nastaví základní identifikátor URI a zachová řádkové informace.
Parse(String)	Vytvoří nový XDocument z řetězce.
Remove()	Odebere tento uzel z nadřazeného objektu. (Zděděno od XNode)
RemoveAnnotations(Type)	Odebere poznámky zadaného typu z tohoto XObject. (Zděděno od XObject)
RemoveAnnotations<T>()	Odebere poznámky zadaného typu z tohoto XObject. (Zděděno od XObject)
RemoveNodes()	Odebere podřízené uzly z tohoto dokumentu nebo prvku. (Zděděno od XContainer)
ReplaceNodes(Object)	Nahradí podřízené uzly tohoto dokumentu nebo elementu zadaným obsahem. (Zděděno od XContainer)
ReplaceNodes(Object[])	Nahradí podřízené uzly tohoto dokumentu nebo elementu zadaným obsahem. (Zděděno od XContainer)
ReplaceWith(Object)	Nahradí tento uzel zadaným obsahem. (Zděděno od XNode)
ReplaceWith(Object[])	Nahradí tento uzel zadaným obsahem. (Zděděno od XNode)
Save(Stream, SaveOptions)	Výstupem je XDocument zadané Stream, volitelně určení chování formátování.
Save(Stream)	Vypíše toto XDocument do zadaného Stream.
Save(String, SaveOptions)	Serializovat tento XDocument soubor do souboru, volitelně zakázání formátování.
Save(String)	Serializace souboru XDocument , přepsání existujícího souboru, pokud existuje.
Save(TextWriter, SaveOptions)	Serializovat to XDocument na TextWriter, volitelně zakázání formátování.
Save(TextWriter)	Serializovat to XDocument na .TextWriter
Save(XmlWriter)	Serializovat to XDocument na .XmlWriter
SaveAsync(Stream, SaveOptions, CancellationToken)	Výstupem této XDocument funkce je Stream.
SaveAsync(TextWriter, SaveOptions, CancellationToken)	Zapíše to XDocument na .TextWriter
SaveAsync(XmlWriter, CancellationToken)	Zapíše to XDocument do objektu XmlWriter.
ToString()	Vrátí odsazený KÓD XML pro tento uzel. (Zděděno od XNode)
ToString(SaveOptions)	Vrátí kód XML pro tento uzel a volitelně zakáže formátování. (Zděděno od XNode)
WriteTo(XmlWriter)	Napište tento dokument do souboru XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)	Zapíše základní strom XML tohoto objektu XDocument do zadaného XmlWriter.

Událost

Name	Description
Changed	Vyvolá se, když se tento XObject nebo některý z jeho potomků změnil. (Zděděno od XObject)
Changing	Vyvolá se, když se tento XObject nebo kterýkoli z jejích potomků chystá změnit. (Zděděno od XObject)

Explicitní implementace rozhraní

Name	Description
IXmlLineInfo.HasLineInfo()	Získá hodnotu označující, zda má tento XObject řádek informace. (Zděděno od XObject)
IXmlLineInfo.LineNumber	Získá číslo řádku, které podkladové XmlReader hlášení pro toto XObject. (Zděděno od XObject)
IXmlLineInfo.LinePosition	Získá pozici čáry, kterou základní hlášeno XmlReader pro toto XObject. (Zděděno od XObject)

Metody rozšíření

Name	Description
CreateNavigator(XNode, XmlNameTable)	Vytvoří pro XPathNavigator objekt XNode. Umožňuje XmlNameTable efektivnější zpracování výrazů XPath.
CreateNavigator(XNode)	Vytvoří pro XPathNavigator objekt XNode.
ToXPathNavigable(XNode)	Vrátí přístupový objekt, který umožňuje procházet a upravovat zadané XNodeobjekty .
Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)	Ověří, zda je XDocument v objektu XSD v objektu XmlSchemaSetxSD volitelně naplněný strom XML sadou informací po ověření schématu (PSVI).
Validate(XDocument, XmlSchemaSet, ValidationEventHandler)	Tato metoda ověří, že XDocument odpovídá XSD v objektu XmlSchemaSet.
XPathEvaluate(XNode, String, IXmlNamespaceResolver)	Vyhodnotí výraz XPath a přeloží předpony oboru názvů pomocí zadaného IXmlNamespaceResolvervýrazu .
XPathEvaluate(XNode, String)	Vyhodnotí výraz XPath.
XPathSelectElement(XNode, String, IXmlNamespaceResolver)	Vybere výraz XElement XPath, přeloží předpony oboru názvů pomocí zadaného IXmlNamespaceResolvervýrazu .
XPathSelectElement(XNode, String)	Vybere XElement výraz XPath.
XPathSelectElements(XNode, String, IXmlNamespaceResolver)	Vybere kolekci prvků pomocí výrazu XPath, přeloží předpony oboru názvů pomocí zadaného IXmlNamespaceResolvervýrazu .
XPathSelectElements(XNode, String)	Vybere kolekci prvků pomocí výrazu XPath.

Viz také

• XNamespace
• XDeclaration
• XElement
• XNode
• Přehled LINQ to XML
• Přehled třídy XDocument