XDocument Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Xml.Linq

Zestaw:: System.Xml.XDocument.dll

Zestaw:: System.Xml.Linq.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Reprezentuje dokument XML. Aby zapoznać się ze składnikami i użyciem XDocument obiektu, zobacz XDocument Class Overview (Omówienie klasy 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

Dziedziczenie: Object

XObject

XNode

XContainer
XDocument

Przykłady

Poniższy przykład tworzy dokument, a następnie dodaje do niego komentarz i element. Następnie komponuje inny dokument przy użyciu wyników zapytania.

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)

Ten przykład generuje następujące wyniki:

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

Uwagi

Aby uzyskać szczegółowe informacje o prawidłowej zawartości elementu XDocument, zobacz Prawidłowa zawartość elementów XElement i obiektów XDocument.

Konstruktory

XDocument()	Inicjuje nowe wystąpienie klasy XDocument.
XDocument(Object[])	Inicjuje XDocument nowe wystąpienie klasy z określoną zawartością.
XDocument(XDeclaration, Object[])	Inicjuje XDocument nowe wystąpienie klasy z określoną zawartością XDeclaration .
XDocument(XDocument)	Inicjuje XDocument nowe wystąpienie klasy z istniejącego XDocument obiektu.

Właściwości

BaseUri	Pobiera podstawowy identyfikator URI dla tego XObjectelementu . (Odziedziczone po XObject)
Declaration	Pobiera lub ustawia deklarację XML dla tego dokumentu.
Document	Pobiera element XDocument dla tego pliku XObject. (Odziedziczone po XObject)
DocumentType	Pobiera definicję typu dokumentu (DTD) dla tego dokumentu.
FirstNode	Pobiera pierwszy węzeł podrzędny tego węzła. (Odziedziczone po XContainer)
LastNode	Pobiera ostatni węzeł podrzędny tego węzła. (Odziedziczone po XContainer)
NextNode	Pobiera następny węzeł równorzędny tego węzła. (Odziedziczone po XNode)
NodeType	Pobiera typ węzła dla tego węzła.
Parent	Pobiera element nadrzędny XElement tego XObjectelementu . (Odziedziczone po XObject)
PreviousNode	Pobiera poprzedni węzeł równorzędny tego węzła. (Odziedziczone po XNode)
Root	Pobiera element główny drzewa XML dla tego dokumentu.

Metody

Add(Object)	Dodaje określoną zawartość jako elementy podrzędne tego XContainerelementu . (Odziedziczone po XContainer)
Add(Object[])	Dodaje określoną zawartość jako elementy podrzędne tego XContainerelementu . (Odziedziczone po XContainer)
AddAfterSelf(Object)	Dodaje określoną zawartość bezpośrednio po tym węźle. (Odziedziczone po XNode)
AddAfterSelf(Object[])	Dodaje określoną zawartość bezpośrednio po tym węźle. (Odziedziczone po XNode)
AddAnnotation(Object)	Dodaje obiekt do listy adnotacji tego XObjectelementu . (Odziedziczone po XObject)
AddBeforeSelf(Object)	Dodaje określoną zawartość bezpośrednio przed tym węzłem. (Odziedziczone po XNode)
AddBeforeSelf(Object[])	Dodaje określoną zawartość bezpośrednio przed tym węzłem. (Odziedziczone po XNode)
AddFirst(Object)	Dodaje określoną zawartość jako pierwsze elementy podrzędne tego dokumentu lub elementu. (Odziedziczone po XContainer)
AddFirst(Object[])	Dodaje określoną zawartość jako pierwsze elementy podrzędne tego dokumentu lub elementu. (Odziedziczone po XContainer)
Ancestors()	Zwraca kolekcję elementów nadrzędnych tego węzła. (Odziedziczone po XNode)
Ancestors(XName)	Zwraca odfiltrowaną kolekcję elementów nadrzędnych tego węzła. W kolekcji znajdują się tylko elementy, które mają dopasowanie XName . (Odziedziczone po XNode)
Annotation(Type)	Pobiera pierwszy obiekt adnotacji określonego typu z tego XObjecttypu . (Odziedziczone po XObject)
Annotation<T>()	Pobiera pierwszy obiekt adnotacji określonego typu z tego XObjecttypu . (Odziedziczone po XObject)
Annotations(Type)	Pobiera kolekcję adnotacji określonego typu dla tego typu XObject. (Odziedziczone po XObject)
Annotations<T>()	Pobiera kolekcję adnotacji określonego typu dla tego typu XObject. (Odziedziczone po XObject)
CreateReader()	Tworzy element XmlReader dla tego węzła. (Odziedziczone po XNode)
CreateReader(ReaderOptions)	Tworzy obiekt XmlReader z opcjami określonymi `readerOptions` przez parametr . (Odziedziczone po XNode)
CreateWriter()	Tworzy element XmlWriter , który może służyć do dodawania węzłów do elementu XContainer. (Odziedziczone po XContainer)
DescendantNodes()	Zwraca kolekcję węzłów podrzędnych dla tego dokumentu lub elementu w kolejności dokumentu. (Odziedziczone po XContainer)
Descendants()	Zwraca kolekcję elementów podrzędnych dla tego dokumentu lub elementu w kolejności dokumentu. (Odziedziczone po XContainer)
Descendants(XName)	Zwraca filtrowaną kolekcję elementów podrzędnych dla tego dokumentu lub elementu w kolejności dokumentu. W kolekcji znajdują się tylko elementy, które mają dopasowanie XName . (Odziedziczone po XContainer)
Element(XName)	Pobiera pierwszy element podrzędny (w kolejności dokumentu) z określonym XNameelementem . (Odziedziczone po XContainer)
Elements()	Zwraca kolekcję elementów podrzędnych tego elementu lub dokumentu w kolejności dokumentu. (Odziedziczone po XContainer)
Elements(XName)	Zwraca odfiltrowaną kolekcję elementów podrzędnych tego elementu lub dokumentu w kolejności dokumentu. W kolekcji znajdują się tylko elementy, które mają dopasowanie XName . (Odziedziczone po XContainer)
ElementsAfterSelf()	Zwraca kolekcję elementów równorzędnych po tym węźle w kolejności dokumentu. (Odziedziczone po XNode)
ElementsAfterSelf(XName)	Zwraca odfiltrowaną kolekcję elementów równorzędnych po tym węźle w kolejności dokumentu. W kolekcji znajdują się tylko elementy, które mają dopasowanie XName . (Odziedziczone po XNode)
ElementsBeforeSelf()	Zwraca kolekcję elementów równorzędnych przed tym węzłem w kolejności dokumentu. (Odziedziczone po XNode)
ElementsBeforeSelf(XName)	Zwraca filtrowaną kolekcję elementów równorzędnych przed tym węzłem w kolejności dokumentu. W kolekcji znajdują się tylko elementy, które mają dopasowanie XName . (Odziedziczone po XNode)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IsAfter(XNode)	Określa, czy bieżący węzeł pojawia się po określonym węźle pod względem kolejności dokumentu. (Odziedziczone po XNode)
IsBefore(XNode)	Określa, czy bieżący węzeł pojawia się przed określonym węzłem pod względem kolejności dokumentu. (Odziedziczone po XNode)
Load(Stream)	Tworzy nowe XDocument wystąpienie przy użyciu określonego strumienia.
Load(Stream, LoadOptions)	Tworzy nowe XDocument wystąpienie przy użyciu określonego strumienia, opcjonalnie zachowując biały odstęp, ustawiając podstawowy identyfikator URI i zachowując informacje o wierszu.
Load(String)	Tworzy nowy XDocument element z pliku.
Load(String, LoadOptions)	Tworzy nowy XDocument element z pliku, opcjonalnie zachowując biały odstęp, ustawiając podstawowy identyfikator URI i zachowując informacje o wierszu.
Load(TextReader)	Tworzy nowy XDocument element na podstawie elementu TextReader.
Load(TextReader, LoadOptions)	Tworzy nowy XDocument element z elementu TextReader, opcjonalnie zachowując biały odstęp, ustawiając podstawowy identyfikator URI i zachowując informacje o wierszu.
Load(XmlReader)	Tworzy nowy XDocument element na podstawie elementu XmlReader.
Load(XmlReader, LoadOptions)	Ładuje element XDocument z elementu XmlReader, opcjonalnie ustawiając podstawowy identyfikator URI i zachowując informacje o wierszu.
LoadAsync(Stream, LoadOptions, CancellationToken)	Asynchronicznie tworzy nowe XDocument i inicjuje bazowe drzewo XML z określonego strumienia, opcjonalnie zachowując białe znaki.
LoadAsync(TextReader, LoadOptions, CancellationToken)	Tworzy nowe XDocument i inicjuje bazowe drzewo XML przy użyciu określonego TextReader parametru, opcjonalnie zachowując biały znak.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Tworzy nowy XDocument element zawierający zawartość określonego XmlReaderelementu .
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
Nodes()	Zwraca kolekcję węzłów podrzędnych tego elementu lub dokumentu w kolejności dokumentu. (Odziedziczone po XContainer)
NodesAfterSelf()	Zwraca kolekcję węzłów równorzędnych po tym węźle w kolejności dokumentu. (Odziedziczone po XNode)
NodesBeforeSelf()	Zwraca kolekcję węzłów równorzędnych przed tym węzłem w kolejności dokumentu. (Odziedziczone po XNode)
Parse(String)	Tworzy nową XDocument wartość na podstawie ciągu.
Parse(String, LoadOptions)	Tworzy nowy XDocument element na podstawie ciągu, opcjonalnie zachowując biały znak, ustawiając podstawowy identyfikator URI i zachowując informacje o wierszu.
Remove()	Usuwa ten węzeł z węzła nadrzędnego. (Odziedziczone po XNode)
RemoveAnnotations(Type)	Usuwa adnotacje określonego typu z tego XObjecttypu . (Odziedziczone po XObject)
RemoveAnnotations<T>()	Usuwa adnotacje określonego typu z tego XObjecttypu . (Odziedziczone po XObject)
RemoveNodes()	Usuwa węzły podrzędne z tego dokumentu lub elementu. (Odziedziczone po XContainer)
ReplaceNodes(Object)	Zamienia węzły podrzędne tego dokumentu lub elementu na określoną zawartość. (Odziedziczone po XContainer)
ReplaceNodes(Object[])	Zamienia węzły podrzędne tego dokumentu lub elementu na określoną zawartość. (Odziedziczone po XContainer)
ReplaceWith(Object)	Zastępuje ten węzeł określoną zawartością. (Odziedziczone po XNode)
ReplaceWith(Object[])	Zastępuje ten węzeł określoną zawartością. (Odziedziczone po XNode)
Save(Stream)	Zwraca tę wartość XDocument do określonego Streamelementu .
Save(Stream, SaveOptions)	Zwraca tę XDocument wartość do określonego Streamelementu , opcjonalnie określając zachowanie formatowania.
Save(String)	Serializuj to XDocument do pliku, zastępując istniejący plik, jeśli istnieje.
Save(String, SaveOptions)	Serializuj to XDocument do pliku, opcjonalnie wyłączając formatowanie.
Save(TextWriter)	Serializuj to XDocument do .TextWriter
Save(TextWriter, SaveOptions)	Serializuj to XDocument do TextWriterelementu , opcjonalnie wyłączając formatowanie.
Save(XmlWriter)	Serializuj to XDocument do elementu XmlWriter.
SaveAsync(Stream, SaveOptions, CancellationToken)	Wyprowadź tę wartość XDocument do elementu Stream.
SaveAsync(TextWriter, SaveOptions, CancellationToken)	Zapisuje to XDocument w obiekcie TextWriter.
SaveAsync(XmlWriter, CancellationToken)	Zapisuje to XDocument w obiekcie XmlWriter.
ToString()	Zwraca wcięty kod XML dla tego węzła. (Odziedziczone po XNode)
ToString(SaveOptions)	Zwraca kod XML dla tego węzła, opcjonalnie wyłączając formatowanie. (Odziedziczone po XNode)
WriteTo(XmlWriter)	Napisz ten dokument do elementu XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)	Zapisuje bazowe drzewo XML XDocument do określonego XmlWriterelementu .
WriteToAsync(XmlWriter, CancellationToken)	Zapisuje bieżący węzeł w obiekcie XmlWriter. (Odziedziczone po XNode)

Zdarzenia

Changed	Podniesione, gdy to XObject lub którykolwiek z jego elementów potomnych uległy zmianie. (Odziedziczone po XObject)
Changing	Podniesione, gdy ten XObject lub którykolwiek z jego elementów potomnych ma ulec zmianie. (Odziedziczone po XObject)

Jawne implementacje interfejsu

IXmlLineInfo.HasLineInfo()	Pobiera wartość wskazującą, czy ma to XObject informacje w wierszu. (Odziedziczone po XObject)
IXmlLineInfo.LineNumber	Pobiera numer wiersza, który jest XmlReader zgłaszany dla tego pliku XObject. (Odziedziczone po XObject)
IXmlLineInfo.LinePosition	Pobiera pozycję wiersza, która jest zgłaszana jako podstawowa XmlReader dla tego XObjectelementu . (Odziedziczone po XObject)

Metody rozszerzania

Validate(XDocument, XmlSchemaSet, ValidationEventHandler)	Ta metoda sprawdza, czy element XDocument jest zgodny z XSD w elemecie XmlSchemaSet.
Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)	Sprawdza, czy element XDocument jest zgodny z XSD w XmlSchemaSetpliku , opcjonalnie wypełnia drzewo XML przy użyciu zestawu informacji po weryfikacji schematu (PSVI).
CreateNavigator(XNode)	Tworzy element XPathNavigator dla elementu XNode.
CreateNavigator(XNode, XmlNameTable)	Tworzy element XPathNavigator dla elementu XNode. Umożliwia XmlNameTable bardziej wydajne przetwarzanie wyrażeń XPath.
XPathEvaluate(XNode, String)	Oblicza wyrażenie XPath.
XPathEvaluate(XNode, String, IXmlNamespaceResolver)	Ocenia wyrażenie XPath rozpoznając prefiksy przestrzeni nazw przy użyciu określonego IXmlNamespaceResolverelementu .
XPathSelectElement(XNode, String)	Wybiera wyrażenie XElement XPath przy użyciu.
XPathSelectElement(XNode, String, IXmlNamespaceResolver)	XElement Wybiera przy użyciu wyrażenia XPath rozpoznawanie prefiksów przestrzeni nazw przy użyciu określonego IXmlNamespaceResolver.
XPathSelectElements(XNode, String)	Wybiera kolekcję elementów przy użyciu wyrażenia XPath.
XPathSelectElements(XNode, String, IXmlNamespaceResolver)	Wybiera kolekcję elementów przy użyciu wyrażenia XPath, rozpoznawanie prefiksów przestrzeni nazw przy użyciu określonego IXmlNamespaceResolverelementu .
ToXPathNavigable(XNode)	Zwraca metodę dostępu umożliwiającą nawigowanie i edytowanie określonego XNodeelementu .

Dotyczy