XDocument Klasa

Definicja

Przestrzeń nazw:

System.Xml.Linq

Zestaw:

System.Xml.XDocument.dll

Źródło:

XDocument.cs

Reprezentuje dokument XML. Aby zapoznać się ze składnikami i użyciem XDocument obiektu, zobacz XDocument Class Overview (Omówienie klasy XDocument).

C#

public class XDocument : System.Xml.Linq.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.

C#

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);

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

XML

<!--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 obiektu 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ą i określoną XDeclaration zawartością.
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 XObjectpliku . (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 XObjectobiektu . (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 elementu XObject. (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 XObjectelementu . (Odziedziczone po XObject)
Annotation<T>()	Pobiera pierwszy obiekt adnotacji określonego typu z tego XObjectelementu . (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 element 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 znak, ustawiając podstawowy identyfikator URI i zachowując informacje o wierszu.
Load(String)	Tworzy nowy XDocument element na podstawie pliku.
Load(String, LoadOptions)	Tworzy nowy XDocument element na podstawie pliku, opcjonalnie zachowując biały znak, 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 na podstawie TextReaderelementu , opcjonalnie zachowując biały znak, 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 XmlReaderelementu , 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 XObjectelementu . (Odziedziczone po XObject)
RemoveAnnotations<T>()	Usuwa adnotacje określonego typu z tego XObjectelementu . (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 to XDocument 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 obiektu 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ęcie 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)	Zapisz ten dokument w obiekcie XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)	Zapisuje bazowe drzewo XML tego XDocument do określonego XmlWriter.

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 zostaną zmienione. (Odziedziczone po XObject)

Jawne implementacje interfejsu

IXmlLineInfo.HasLineInfo()	Pobiera wartość wskazującą, czy ma to XObject informacje o wierszu. (Odziedziczone po XObject)
IXmlLineInfo.LineNumber	Pobiera numer wiersza zgłoszony przez XObjectten XmlReader element . (Odziedziczone po XObject)
IXmlLineInfo.LinePosition	Pobiera pozycję wiersza zgłoszoną przez element bazowy 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

Zobacz też

• XNamespace
• XDeclaration
• XElement
• XNode
• LINQ to XML — przegląd
• XDocument, klasa — omówienie