XDocument Třída

Definice

Obor názvů:

System.Xml.Linq

Sestavení:

System.Xml.XDocument.dll

Sestavení:

System.Xml.Linq.dll

Sestavení:

netstandard.dll

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 přidá do něj komentář a prvek. Potom vytvoří další 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 XDocumentnaleznete v tématu Platný obsah XElement a objekty XDocument.

Konstruktory

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

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 .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

Add(Object)	Přidá zadaný obsah jako podřízené položky XContainer. (Zděděno od XContainer)
Add(Object[])	Přidá zadaný obsah jako podřízené položky XContainer. (Zděděno od XContainer)
AddAfterSelf(Object)	Přidá zadaný obsah hned za tímto uzlem. (Zděděno od XNode)
AddAfterSelf(Object[])	Přidá zadaný obsah hned 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. V kolekci jsou zahrnuty pouze prvky, které mají shodu 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 příkaz XmlReader . (Zděděno od XNode)
CreateReader(ReaderOptions)	XmlReader Vytvoří s možnostmi určenými parametremreaderOptions. (Zděděno od XNode)
CreateWriter()	XmlWriter Vytvoří, která se dá použít k přidání uzlů do XContainersouboru . (Zděděno od XContainer)
DescendantNodes()	Vrátí kolekci potomků 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í dokumentů. V kolekci jsou zahrnuty pouze prvky, které mají shodu XName . (Zděděno od XContainer)
Element(XName)	Získá první (v pořadí dokumentů) 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. V kolekci jsou zahrnuty pouze prvky, které mají shodu XName . (Zděděno od XContainer)
ElementsAfterSelf()	Vrátí kolekci elementů na stejné úrovni za tímto uzlem v pořadí dokumentů. (Zděděno od XNode)
ElementsAfterSelf(XName)	Vrátí filtrovanou kolekci elementů na stejné úrovni za tímto uzlem v pořadí dokumentů. V kolekci jsou zahrnuty pouze prvky, které mají shodu XName . (Zděděno od XNode)
ElementsBeforeSelf()	Vrátí kolekci elementů na stejné úrovni před tímto uzlem v pořadí dokumentu. (Zděděno od XNode)
ElementsBeforeSelf(XName)	Vrátí filtrovanou kolekci elementů na stejné úrovni před tímto uzlem v pořadí dokumentů. V kolekci jsou zahrnuty pouze prvky, které mají shodu XName . (Zděděno od XNode)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Type Získá aktuální instanci. (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)	Vytvoří novou XDocument instanci pomocí zadaného datového proudu.
Load(Stream, LoadOptions)	Vytvoří novou XDocument instanci pomocí zadaného datového proudu, případně zachováním prázdného místa, nastavením základního identifikátoru URI a zachováním informací o řádku.
Load(String)	Vytvoří novou XDocument ze souboru.
Load(String, LoadOptions)	Vytvoří novou XDocument ze souboru, volitelně zachová prázdné místo, nastaví základní identifikátor URI a zachová informace o řádku.
Load(TextReader)	Vytvoří novou XDocument z objektu TextReader.
Load(TextReader, LoadOptions)	Vytvoří novou XDocument z volitelného zachování prázdného TextReadermísta, nastavení základního identifikátoru URI a zachování informací o řádku.
Load(XmlReader)	Vytvoří novou XDocument z objektu XmlReader.
Load(XmlReader, LoadOptions)	XDocument Načte z XmlReader, volitelně nastavení základního identifikátoru URI a zachování informací o řádku.
LoadAsync(Stream, LoadOptions, CancellationToken)	Asynchronně vytvoří nový XDocument a inicializuje základní strom XML ze zadaného datového proudu, volitelně zachová prázdné místo.
LoadAsync(TextReader, LoadOptions, CancellationToken)	Vytvoří nový XDocument a inicializuje jeho základní strom XML pomocí zadaného TextReader parametru, volitelně zachování prázdného místa.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Vytvoří nový XDocument obsah zadaného XmlReadersouboru .
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
Nodes()	Vrátí kolekci podřízených uzlů tohoto prvku nebo dokumentu v pořadí dokumentů. (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)	Vytvoří novou XDocument z řetězce.
Parse(String, LoadOptions)	Vytvoří novou XDocument z řetězce, volitelně zachová prázdné místo, nastaví základní identifikátor URI a zachová řádkové informace.
Remove()	Odebere tento uzel z nadřazeného objektu. (Zděděno od XNode)
RemoveAnnotations(Type)	Odebere z tohoto XObjecttypu poznámky zadaného typu . (Zděděno od XObject)
RemoveAnnotations<T>()	Odebere z tohoto XObjecttypu poznámky zadaného typu . (Zděděno od XObject)
RemoveNodes()	Odebere podřízené uzly z tohoto dokumentu nebo elementu. (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)	Výstupem je XDocument zadaný Stream.
Save(Stream, SaveOptions)	Vypíše toto XDocument do zadaného Stream, volitelně určení chování formátování.
Save(String)	Serializujte ho XDocument na soubor a přepíšete existující soubor, pokud existuje.
Save(String, SaveOptions)	Serializujte ho XDocument do souboru, volitelně zakázání formátování.
Save(TextWriter)	Serializovat to XDocument na TextWriter.
Save(TextWriter, SaveOptions)	Serializujte ho XDocument na TextWriter, volitelně zakázání formátování.
Save(XmlWriter)	Serializovat to XDocument na .XmlWriter
SaveAsync(Stream, SaveOptions, CancellationToken)	Výstupem Streamtohoto XDocument příkazu je .
SaveAsync(TextWriter, SaveOptions, CancellationToken)	Zapíše to XDocument do souboru TextWriter.
SaveAsync(XmlWriter, CancellationToken)	Zapíše to XDocument do souboru XmlWriter.
ToString()	Vrátí odsazený KÓD XML pro tento uzel. (Zděděno od XNode)
ToString(SaveOptions)	Vrátí xml pro tento uzel, volitelně zakázání formátování. (Zděděno od XNode)
WriteTo(XmlWriter)	Napište tento dokument do souboru XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)	Zapíše do zadaného XmlWriterobjektu XML základní strom XDocument .
WriteToAsync(XmlWriter, CancellationToken)	Zapíše aktuální uzel do objektu XmlWriter. (Zděděno od XNode)

událost

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 to XObject nebo některý z jejích potomků chystá změnit. (Zděděno od XObject)

Explicitní implementace rozhraní

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 tento XObject. (Zděděno od XObject)
IXmlLineInfo.LinePosition	Získá pozici čáry, kterou podklad XmlReader hlášen pro tento XObject. (Zděděno od XObject)

Metody rozšíření

Validate(XDocument, XmlSchemaSet, ValidationEventHandler)	Tato metoda ověří, že XDocument odpovídá XSD v objektu XmlSchemaSet.
Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)	Ověří, že XDocument odpovídá XSD ve XmlSchemaSetstromové struktuře XML, volitelně naplní datovou sadu psVI (post-schema-validation).
CreateNavigator(XNode)	XPathNavigator Vytvoří pro objekt XNode.
CreateNavigator(XNode, XmlNameTable)	XPathNavigator Vytvoří pro objekt XNode. Umožňuje XmlNameTable efektivnější zpracování výrazů XPath.
XPathEvaluate(XNode, String)	Vyhodnotí výraz XPath.
XPathEvaluate(XNode, String, IXmlNamespaceResolver)	Vyhodnotí výraz XPath a přeloží předpony oboru názvů pomocí zadaného IXmlNamespaceResolvervýrazu .
XPathSelectElement(XNode, String)	XElement Vybere výraz XPath.
XPathSelectElement(XNode, String, IXmlNamespaceResolver)	XElement Vybere výraz XPath, přeloží předpony oboru názvů pomocí zadaného IXmlNamespaceResolvervýrazu .
XPathSelectElements(XNode, String)	Vybere kolekci prvků pomocí výrazu XPath.
XPathSelectElements(XNode, String, IXmlNamespaceResolver)	Vybere kolekci prvků pomocí výrazu XPath a přeloží předpony oboru názvů pomocí zadaného IXmlNamespaceResolvervýrazu .
ToXPathNavigable(XNode)	Vrátí přístupový objekt, který umožňuje navigaci a úpravě zadaného objektu XNode.

Viz také

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