XDocument Třída

Definice

Obor názvů:

System.Xml.Linq

Sestavení:

System.Xml.XDocument.dll

Zdroj:

XDocument.cs

Představuje dokument XML. Součásti a použití objektu XDocument najdete 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. Pak 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 XDocumentnajdete v tématu Platný obsah objektů XElement a 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 obsahem a .
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í xml deklarace pro tento dokument.
Document	Získá pro XDocument tento 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řazenou XElement hodnotu tohoto XObjectobjektu . (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 tohoto XContainersouboru . (Zděděno od XContainer)
Add(Object[])	Přidá zadaný obsah jako podřízené položky tohoto XContainersouboru . (Zděděno od XContainer)
AddAfterSelf(Object)	Přidá zadaný obsah ihned za tento uzel. (Zděděno od XNode)
AddAfterSelf(Object[])	Přidá zadaný obsah ihned za tento uzel. (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 prvku. (Zděděno od XContainer)
AddFirst(Object[])	Přidá zadaný obsah jako první podřízené položky tohoto dokumentu nebo prvku. (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 hodnoty. (Zděděno od XNode)
Annotation(Type)	Získá první objekt poznámky zadaného typu z tohoto XObject. (Zděděno od XObject)
Annotation<T>()	Získá první objekt poznámky 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 XmlReader tento uzel objekt . (Zděděno od XNode)
CreateReader(ReaderOptions)	Vytvoří s XmlReader možnostmi určený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 elementů pro tento dokument nebo prvek v pořadí dokumentů. (Zděděno od XContainer)
Descendants(XName)	Vrátí filtrovanou kolekci následnických prvků pro tento dokument nebo prvek v pořadí dokumentů. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající XName hodnoty. (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í dokumentů. (Zděděno od XContainer)
Elements(XName)	Vrátí filtrovanou kolekci podřízených prvků tohoto prvku nebo dokumentu v pořadí dokumentů. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající XName hodnoty. (Zděděno od XContainer)
ElementsAfterSelf()	Vrátí kolekci prvků na stejné úrovni za tímto uzlem v pořadí dokumentů. (Zděděno od XNode)
ElementsAfterSelf(XName)	Vrátí filtrovanou kolekci prvků na stejné úrovni za tímto uzlem v pořadí dokumentů. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající XName hodnoty. (Zděděno od XNode)
ElementsBeforeSelf()	Vrátí kolekci prvků na stejné úrovni před tímto uzlem v pořadí dokumentů. (Zděděno od XNode)
ElementsBeforeSelf(XName)	Vrátí filtrovanou kolekci prvků na stejné úrovni před tímto uzlem v pořadí dokumentů. Do kolekce jsou zahrnuty pouze prvky, které mají odpovídající XName hodnoty. (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í hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
IsAfter(XNode)	Určuje, zda se aktuální uzel zobrazí za zadaným uzlem z hlediska pořadí dokumentů. (Zděděno od XNode)
IsBefore(XNode)	Určuje, zda se aktuální uzel zobrazuje 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, volitelně zachová prázdné znaky, nastaví základní identifikátor URI a zachová informace o řádku.
Load(String)	Vytvoří nový XDocument ze souboru.
Load(String, LoadOptions)	Vytvoří nový XDocument ze souboru, volitelně zachová prázdné znaky, nastaví základní identifikátor URI a zachová informace o řádku.
Load(TextReader)	Vytvoří nový XDocument z .TextReader
Load(TextReader, LoadOptions)	Vytvoří nový XDocument z objektu TextReader, volitelně zachová prázdné znaky, nastaví základní identifikátor URI a zachová informace o řádku.
Load(XmlReader)	Vytvoří nový XDocument z objektu XmlReader.
Load(XmlReader, LoadOptions)	XDocument Načte z objektu XmlReader, volitelně nastaví základní identifikátor URI a zachová informace o řádku.
LoadAsync(Stream, LoadOptions, CancellationToken)	Asynchronně vytvoří nový XDocument a inicializuje jeho základní strom XML ze zadaného datového proudu, volitelně zachová prázdné znaky.
LoadAsync(TextReader, LoadOptions, CancellationToken)	Vytvoří nový XDocument a inicializuje jeho 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 XmlReaderobjektu .
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (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í dokumentů. (Zděděno od XNode)
NodesBeforeSelf()	Vrátí kolekci uzlů na stejné úrovni před tímto uzlem v pořadí dokumentů. (Zděděno od XNode)
Parse(String)	Vytvoří nový XDocument z řetězce.
Parse(String, LoadOptions)	Vytvoří nový XDocument z řetězce, volitelně zachová prázdné znaky, nastaví základní identifikátor URI a zachová informace o řádku.
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 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)	Vypíše tuto XDocument hodnotu do zadaného Streamparametru .
Save(Stream, SaveOptions)	Vypíše tuto XDocument hodnotu do zadaného Streamobjektu , který volitelně určuje chování formátování.
Save(String)	Serializovat do XDocument souboru, přepsání existujícího souboru, pokud existuje.
Save(String, SaveOptions)	Serializovat do XDocument souboru, volitelně zakázat formátování.
Save(TextWriter)	Serializovat do XDocumentTextWriter.
Save(TextWriter, SaveOptions)	Serializujte tuto XDocument položku na TextWriter, volitelně zakažte formátování.
Save(XmlWriter)	Serializovat do XDocument .XmlWriter
SaveAsync(Stream, SaveOptions, CancellationToken)	Vypíše tuto XDocument zprávu do .Stream
SaveAsync(TextWriter, SaveOptions, CancellationToken)	Zapíše to XDocument do .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)	Zapsat tento dokument do .XmlWriter
WriteToAsync(XmlWriter, CancellationToken)	Zapíše podkladový strom XML tohoto XDocument do zadaného XmlWriterobjektu .

Událost

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

Explicitní implementace rozhraní

IXmlLineInfo.HasLineInfo()	Získá hodnotu označující, zda má XObject nebo nemá informace o řádku. (Zděděno od XObject)
IXmlLineInfo.LineNumber	Získá číslo řádku, který podkladová XmlReader sestava pro tento XObject. (Zděděno od XObject)
IXmlLineInfo.LinePosition	Získá pozici čáry, kterou podkladová XmlReader hlásí pro tento XObject. (Zděděno od XObject)

Metody rozšíření

Validate(XDocument, XmlSchemaSet, ValidationEventHandler)	Tato metoda ověří, jestli objekt XDocument vyhovuje XSD v objektu XmlSchemaSet.
Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)	Ověří, jestli objekt XDocument odpovídá XSD v objektu XmlSchemaSet, případně naplňuje strom XML informační sadou psVI (post-schema-validation infoset).
CreateNavigator(XNode)	Vytvoří objekt XPathNavigator pro XNode.
CreateNavigator(XNode, XmlNameTable)	Vytvoří objekt XPathNavigator pro 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 IXmlNamespaceResolverobjektu .
XPathSelectElement(XNode, String)	Vybere pomocí XElement výrazu XPath.
XPathSelectElement(XNode, String, IXmlNamespaceResolver)	Vybere pomocí XElement výrazu XPath a přeloží předpony oboru názvů pomocí zadaného IXmlNamespaceResolverobjektu .
XPathSelectElements(XNode, String)	Vybere kolekci prvků pomocí výrazu XPath.
XPathSelectElements(XNode, String, IXmlNamespaceResolver)	Vybere kolekci elementů pomocí výrazu XPath a přeloží předpony oboru názvů pomocí zadaného IXmlNamespaceResolverobjektu .
ToXPathNavigable(XNode)	Vrátí přístup, který umožňuje navigaci a úpravu zadaného XNodeobjektu .

Viz také

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