XDocument Klasa

Definicja

Reprezentuje dokument XML.Represents an XML document. Aby uzyskać składniki i użycie XDocument obiektu, zobacz temat Omówienie klasy XDocument.For the components and usage of an XDocument object, see XDocument Class Overview.

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

Przykłady

Poniższy przykład tworzy dokument, a następnie dodaje komentarz i element do niego.The following example creates a document, and then adds a comment and an element to it. Następnie tworzy inny dokument przy użyciu wyników zapytania.It then composes another document using the results of a query.

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 example produces the following output:

<!--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 XDocument, zobacz prawidłowa zawartość obiektów XElement i XDocument.For details about the valid content of an XDocument, see Valid Content of XElement and XDocument Objects.

Konstruktory

XDocument()

Inicjuje nowe wystąpienie klasy XDocument klasy.Initializes a new instance of the XDocument class.

XDocument(Object[])

Inicjuje nowe wystąpienie XDocument klasy z określoną zawartością.Initializes a new instance of the XDocument class with the specified content.

XDocument(XDeclaration, Object[])

Inicjuje nowe wystąpienie XDocument klasy z określoną XDeclaration zawartością i.Initializes a new instance of the XDocument class with the specified XDeclaration and content.

XDocument(XDocument)

Inicjuje nowe wystąpienie XDocument klasy z istniejącego XDocument obiektu.Initializes a new instance of the XDocument class from an existing XDocument object.

Właściwości

BaseUri

Pobiera podstawowy identyfikator URI dla tego XObjectelementu.Gets the base URI for this XObject.

(Odziedziczone po XObject)
Declaration

Pobiera lub ustawia deklarację XML dla tego dokumentu.Gets or sets the XML declaration for this document.

Document

Pobiera dla tego XObjectelementu. XDocumentGets the XDocument for this XObject.

(Odziedziczone po XObject)
DocumentType

Pobiera definicję typu dokumentu (DTD) dla tego dokumentu.Gets the Document Type Definition (DTD) for this document.

FirstNode

Pobiera pierwszy węzeł podrzędny tego węzła.Gets the first child node of this node.

(Odziedziczone po XContainer)
LastNode

Pobiera ostatni węzeł podrzędny tego węzła.Gets the last child node of this node.

(Odziedziczone po XContainer)
NextNode

Pobiera następny węzeł równorzędny tego węzła.Gets the next sibling node of this node.

(Odziedziczone po XNode)
NodeType

Pobiera typ węzła dla tego węzła.Gets the node type for this node.

Parent

Pobiera element nadrzędny XElement tego XObjectelementu.Gets the parent XElement of this XObject.

(Odziedziczone po XObject)
PreviousNode

Pobiera poprzedni węzeł równorzędny tego węzła.Gets the previous sibling node of this node.

(Odziedziczone po XNode)
Root

Pobiera element główny drzewa XML dla tego dokumentu.Gets the root element of the XML Tree for this document.

Metody

Add(Object)

Dodaje określoną zawartość jako elementy podrzędne tego XContainerelementu.Adds the specified content as children of this XContainer.

(Odziedziczone po XContainer)
Add(Object[])

Dodaje określoną zawartość jako elementy podrzędne tego XContainerelementu.Adds the specified content as children of this XContainer.

(Odziedziczone po XContainer)
AddAfterSelf(Object)

Dodaje określoną zawartość bezpośrednio po tym węźle.Adds the specified content immediately after this node.

(Odziedziczone po XNode)
AddAfterSelf(Object[])

Dodaje określoną zawartość bezpośrednio po tym węźle.Adds the specified content immediately after this node.

(Odziedziczone po XNode)
AddAnnotation(Object)

Dodaje obiekt do listy adnotacji tego XObjectelementu.Adds an object to the annotation list of this XObject.

(Odziedziczone po XObject)
AddBeforeSelf(Object)

Dodaje określoną zawartość bezpośrednio przed tym węzłem.Adds the specified content immediately before this node.

(Odziedziczone po XNode)
AddBeforeSelf(Object[])

Dodaje określoną zawartość bezpośrednio przed tym węzłem.Adds the specified content immediately before this node.

(Odziedziczone po XNode)
AddFirst(Object)

Dodaje określoną zawartość jako pierwszy element podrzędny tego dokumentu lub elementu.Adds the specified content as the first children of this document or element.

(Odziedziczone po XContainer)
AddFirst(Object[])

Dodaje określoną zawartość jako pierwszy element podrzędny tego dokumentu lub elementu.Adds the specified content as the first children of this document or element.

(Odziedziczone po XContainer)
Ancestors()

Zwraca kolekcję elementów nadrzędnych tego węzła.Returns a collection of the ancestor elements of this node.

(Odziedziczone po XNode)
Ancestors(XName)

Zwraca filtrowaną kolekcję elementów nadrzędnych tego węzła.Returns a filtered collection of the ancestor elements of this node. Kolekcja zawiera tylko elementy, które XName mają zgodne.Only elements that have a matching XName are included in the collection.

(Odziedziczone po XNode)
Annotation(Type)

Pobiera pierwszy obiekt adnotacji określonego typu z tego XObjectelementu.Gets the first annotation object of the specified type from this XObject.

(Odziedziczone po XObject)
Annotation<T>()

Pobiera pierwszy obiekt adnotacji określonego typu z tego XObjectelementu.Gets the first annotation object of the specified type from this XObject.

(Odziedziczone po XObject)
Annotations(Type)

Pobiera kolekcję adnotacji określonego typu XObject.Gets a collection of annotations of the specified type for this XObject.

(Odziedziczone po XObject)
Annotations<T>()

Pobiera kolekcję adnotacji określonego typu XObject.Gets a collection of annotations of the specified type for this XObject.

(Odziedziczone po XObject)
CreateReader()

XmlReader Tworzy dla tego węzła.Creates an XmlReader for this node.

(Odziedziczone po XNode)
CreateReader(ReaderOptions)

Tworzy z opcjami określonymi readerOptions przez parametr. XmlReaderCreates an XmlReader with the options specified by the readerOptions parameter.

(Odziedziczone po XNode)
CreateWriter()

Tworzy, który może służyć do dodawania węzłów XContainerdo. XmlWriterCreates an XmlWriter that can be used to add nodes to the XContainer.

(Odziedziczone po XContainer)
DescendantNodes()

Zwraca kolekcję węzłów podrzędnych dla tego dokumentu lub elementu w kolejności dokumentu.Returns a collection of the descendant nodes for this document or element, in document order.

(Odziedziczone po XContainer)
Descendants()

Zwraca kolekcję elementów potomnych dla tego dokumentu lub elementu w kolejności dokumentu.Returns a collection of the descendant elements for this document or element, in document order.

(Odziedziczone po XContainer)
Descendants(XName)

Zwraca przefiltrowaną kolekcję elementów podrzędnych dla tego dokumentu lub elementu w kolejności dokumentu.Returns a filtered collection of the descendant elements for this document or element, in document order. Kolekcja zawiera tylko elementy, które XName mają zgodne.Only elements that have a matching XName are included in the collection.

(Odziedziczone po XContainer)
Element(XName)

Pobiera pierwszy (w kolejności dokumentu) element podrzędny o określonym XName.Gets the first (in document order) child element with the specified XName.

(Odziedziczone po XContainer)
Elements()

Zwraca kolekcję elementów podrzędnych tego elementu lub dokumentu w kolejności dokumentu.Returns a collection of the child elements of this element or document, in document order.

(Odziedziczone po XContainer)
Elements(XName)

Zwraca filtrowaną kolekcję elementów podrzędnych tego elementu lub dokumentu w kolejności dokumentu.Returns a filtered collection of the child elements of this element or document, in document order. Kolekcja zawiera tylko elementy, które XName mają zgodne.Only elements that have a matching XName are included in the collection.

(Odziedziczone po XContainer)
ElementsAfterSelf()

Zwraca kolekcję elementów równorzędnych po tym węźle w kolejności dokumentu.Returns a collection of the sibling elements after this node, in document order.

(Odziedziczone po XNode)
ElementsAfterSelf(XName)

Zwraca filtrowaną kolekcję elementów równorzędnych po tym węźle w kolejności dokumentu.Returns a filtered collection of the sibling elements after this node, in document order. Kolekcja zawiera tylko elementy, które XName mają zgodne.Only elements that have a matching XName are included in the collection.

(Odziedziczone po XNode)
ElementsBeforeSelf()

Zwraca kolekcję elementów równorzędnych przed tym węzłem w kolejności dokumentu.Returns a collection of the sibling elements before this node, in document order.

(Odziedziczone po XNode)
ElementsBeforeSelf(XName)

Zwraca filtrowaną kolekcję elementów równorzędnych przed tym węzłem w kolejności dokumentu.Returns a filtered collection of the sibling elements before this node, in document order. Kolekcja zawiera tylko elementy, które XName mają zgodne.Only elements that have a matching XName are included in the collection.

(Odziedziczone po XNode)
Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
IsAfter(XNode)

Określa, czy bieżący węzeł pojawia się po określonym węźle pod warunkiem kolejności dokumentu.Determines if the current node appears after a specified node in terms of document order.

(Odziedziczone po XNode)
IsBefore(XNode)

Określa, czy bieżący węzeł pojawia się przed określonym węzłem w warunkach kolejności dokumentu.Determines if the current node appears before a specified node in terms of document order.

(Odziedziczone po XNode)
Load(Stream)

Tworzy nowe XDocument wystąpienie przy użyciu określonego strumienia.Creates a new XDocument instance by using the specified stream.

Load(Stream, LoadOptions)

Tworzy nowe XDocument wystąpienie przy użyciu określonego strumienia, opcjonalnie zachowuje biały znak, ustawia podstawowy identyfikator URI i przechowując informacje o wierszu.Creates a new XDocument instance by using the specified stream, optionally preserving white space, setting the base URI, and retaining line information.

Load(String)

Tworzy nowy XDocument plik z pliku.Creates a new XDocument from a file.

Load(String, LoadOptions)

Tworzy nowy XDocument plik z pliku, opcjonalnie zachowując biały znak, ustawiając podstawowy identyfikator URI i przechowując informacje o wierszu.Creates a new XDocument from a file, optionally preserving white space, setting the base URI, and retaining line information.

Load(TextReader)

Tworzy nowy XDocument TextReaderz.Creates a new XDocument from a TextReader.

Load(TextReader, LoadOptions)

Tworzy nową XDocument TextReaderz, opcjonalnie zachowuje biały znak, ustawia podstawowy identyfikator URI i przechowując informacje o wierszu.Creates a new XDocument from a TextReader, optionally preserving white space, setting the base URI, and retaining line information.

Load(XmlReader)

Tworzy nowy XDocument XmlReaderz.Creates a new XDocument from an XmlReader.

Load(XmlReader, LoadOptions)

XDocument Ładuje programXmlReaderz, opcjonalnie ustawia podstawowy identyfikator URI i zachowuje informacje o wierszu.Loads an XDocument from an XmlReader, optionally setting the base URI, and retaining line information.

LoadAsync(Stream, LoadOptions, CancellationToken)

Asynchronicznie tworzy nowe XDocument i inicjuje jego bazowe drzewo XML z określonego strumienia, opcjonalnie zachowując odstęp.Asynchronously creates a new XDocument and initializes its underlying XML tree from the specified stream, optionally preserving white space.

LoadAsync(TextReader, LoadOptions, CancellationToken)

Tworzy nowe XDocument i inicjuje swoje bazowe drzewo XML przy użyciu określonego TextReader parametru, opcjonalnie zachowując odstęp.Creates a new XDocument and initializes its underlying XML tree using the specified TextReader parameter, optionally preserving white space.

LoadAsync(XmlReader, LoadOptions, CancellationToken)

Tworzy nowy XDocument zawierający zawartość określonego XmlReader.Creates a new XDocument containing the contents of the specified XmlReader.

MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
Nodes()

Zwraca kolekcję węzłów podrzędnych tego elementu lub dokumentu w kolejności dokumentu.Returns a collection of the child nodes of this element or document, in document order.

(Odziedziczone po XContainer)
NodesAfterSelf()

Zwraca kolekcję węzłów równorzędnych po tym węźle w kolejności dokumentu.Returns a collection of the sibling nodes after this node, in document order.

(Odziedziczone po XNode)
NodesBeforeSelf()

Zwraca kolekcję węzłów równorzędnych przed tym węzłem w kolejności dokumentu.Returns a collection of the sibling nodes before this node, in document order.

(Odziedziczone po XNode)
Parse(String)

Tworzy nową XDocument wartość z ciągu.Creates a new XDocument from a string.

Parse(String, LoadOptions)

Tworzy nową XDocument wartość z ciągu, opcjonalnie zachowując biały znak, ustawiając podstawowy identyfikator URI i przechowując informacje o wierszu.Creates a new XDocument from a string, optionally preserving white space, setting the base URI, and retaining line information.

Remove()

Usuwa ten węzeł z jego elementu nadrzędnego.Removes this node from its parent.

(Odziedziczone po XNode)
RemoveAnnotations(Type)

Usuwa adnotacje określonego typu z tego XObjectelementu.Removes the annotations of the specified type from this XObject.

(Odziedziczone po XObject)
RemoveAnnotations<T>()

Usuwa adnotacje określonego typu z tego XObjectelementu.Removes the annotations of the specified type from this XObject.

(Odziedziczone po XObject)
RemoveNodes()

Usuwa węzły podrzędne z tego dokumentu lub tego elementu.Removes the child nodes from this document or element.

(Odziedziczone po XContainer)
ReplaceNodes(Object)

Zamienia węzły podrzędne tego dokumentu lub elementu na określoną zawartość.Replaces the children nodes of this document or element with the specified content.

(Odziedziczone po XContainer)
ReplaceNodes(Object[])

Zamienia węzły podrzędne tego dokumentu lub elementu na określoną zawartość.Replaces the children nodes of this document or element with the specified content.

(Odziedziczone po XContainer)
ReplaceWith(Object)

Zamienia ten węzeł na określoną zawartość.Replaces this node with the specified content.

(Odziedziczone po XNode)
ReplaceWith(Object[])

Zamienia ten węzeł na określoną zawartość.Replaces this node with the specified content.

(Odziedziczone po XNode)
Save(Stream)

Wyprowadza ten XDocument wynik do określonego Stream.Outputs this XDocument to the specified Stream.

Save(Stream, SaveOptions)

Wyprowadza ten XDocument wynik do określonego Stream, opcjonalnie określając zachowanie formatowania.Outputs this XDocument to the specified Stream, optionally specifying formatting behavior.

Save(String)

Serializacja tego XDocument pliku, zastępując istniejący plik, jeśli istnieje.Serialize this XDocument to a file, overwriting an existing file, if it exists.

Save(String, SaveOptions)

Serializacja tego XDocument elementu do pliku, opcjonalnie wyłączenie formatowania.Serialize this XDocument to a file, optionally disabling formatting.

Save(TextWriter)

Serializacja tego XDocument elementu TextWriterdo.Serialize this XDocument to a TextWriter.

Save(TextWriter, SaveOptions)

XDocument SerializacjaTextWriterdo, opcjonalnie wyłączenie formatowania.Serialize this XDocument to a TextWriter, optionally disabling formatting.

Save(XmlWriter)

Serializować tego XDocument elementu XmlWriterdo.Serialize this XDocument to an XmlWriter.

SaveAsync(Stream, SaveOptions, CancellationToken)

Dane wyjściowe XDocument tego elementu Stream.Output this XDocument to a Stream.

SaveAsync(TextWriter, SaveOptions, CancellationToken)

Zapisuje to XDocument TextWriterw.Writes this XDocument to a TextWriter.

SaveAsync(XmlWriter, CancellationToken)

Zapisuje to XDocument XmlWriterw.Writes this XDocument to an XmlWriter.

ToString()

Zwraca XML z wcięciem dla tego węzła.Returns the indented XML for this node.

(Odziedziczone po XNode)
ToString(SaveOptions)

Zwraca kod XML dla tego węzła, opcjonalnie wyłączając formatowanie.Returns the XML for this node, optionally disabling formatting.

(Odziedziczone po XNode)
WriteTo(XmlWriter)

Napisz ten dokument do XmlWriter.Write this document to an XmlWriter.

WriteToAsync(XmlWriter, CancellationToken)

Zapisuje bazowe drzewo XML tego elementu XDocument do określonego XmlWriter.Writes this XDocument's underlying XML tree to the specified XmlWriter.

Zdarzenia

Changed

Uruchamiany po zmianie XObject tego lub któregokolwiek z jego elementów podrzędnych.Raised when this XObject or any of its descendants have changed.

(Odziedziczone po XObject)
Changing

Uruchamiany, gdy XObject ten lub którykolwiek z jego obiektów podrzędnych zostanie zmieniony.Raised when this XObject or any of its descendants are about to change.

(Odziedziczone po XObject)

Jawne implementacje interfejsu

IXmlLineInfo.HasLineInfo()

Pobiera wartość wskazującą, czy ma ona XObject informacje o wierszu.Gets a value indicating whether or not this XObject has line information.

(Odziedziczone po XObject)
IXmlLineInfo.LineNumber

Pobiera numer wiersza, który jest XmlReader raportowany dla tego XObjectelementu.Gets the line number that the underlying XmlReader reported for this XObject.

(Odziedziczone po XObject)
IXmlLineInfo.LinePosition

Pobiera pozycję wiersza, która jest XmlReader zgłoszona dla tego XObjectelementu.Gets the line position that the underlying XmlReader reported for this XObject.

(Odziedziczone po XObject)

Metody rozszerzania

Validate(XDocument, XmlSchemaSet, ValidationEventHandler)

Ta metoda sprawdza, czy jest XDocument zgodna z XSD XmlSchemaSetw.This method validates that an XDocument conforms to an XSD in an XmlSchemaSet.

Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)

Sprawdza, czy jest XDocument zgodna z elementem XSD XmlSchemaSetw, opcjonalnie wypełniając drzewo XML za pomocą sprawdzonych po schemacie walidacji (PSVI).Validates that an XDocument conforms to an XSD in an XmlSchemaSet, optionally populating the XML tree with the post-schema-validation infoset (PSVI).

CreateNavigator(XNode)

Tworzy dla elementu XNode. XPathNavigatorCreates an XPathNavigator for an XNode.

CreateNavigator(XNode, XmlNameTable)

Tworzy dla elementu XNode. XPathNavigatorCreates an XPathNavigator for an XNode. XmlNameTable Zapewnia wydajniejsze przetwarzanie wyrażeń XPath.The XmlNameTable enables more efficient XPath expression processing.

XPathEvaluate(XNode, String)

Oblicza wyrażenie XPath.Evaluates an XPath expression.

XPathEvaluate(XNode, String, IXmlNamespaceResolver)

Oblicza wyrażenie XPath, rozwiązując prefiksy przestrzeni nazw przy użyciu określonego IXmlNamespaceResolver.Evaluates an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver.

XPathSelectElement(XNode, String)

Wybiera wyrażenie XElement using XPath.Selects an XElement using a XPath expression.

XPathSelectElement(XNode, String, IXmlNamespaceResolver)

Wybiera wyrażenie IXmlNamespaceResolverusing XPath, rozwiązując prefiksy przestrzeni nazw przy użyciu określonego elementu. XElementSelects an XElement using a XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver.

XPathSelectElements(XNode, String)

Wybiera kolekcję elementów przy użyciu wyrażenia XPath.Selects a collection of elements using an XPath expression.

XPathSelectElements(XNode, String, IXmlNamespaceResolver)

Wybiera kolekcję elementów przy użyciu wyrażenia XPath, rozwiązując prefiksy przestrzeni nazw przy użyciu określonego IXmlNamespaceResolverelementu.Selects a collection of elements using an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver.

ToXPathNavigable(XNode)

Zwraca metodę dostępu, która pozwala na przechodzenie i Edytuj określonego XNode.Returns an accessor that allows you to navigate and edit the specified XNode.

Dotyczy

Zobacz też