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.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 elementu XObject .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 XDocument dla tego elementu XObject .Gets 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 elementu XObject .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 elementu XContainer .Adds the specified content as children of this XContainer.

(Odziedziczone po XContainer)
Add(Object[])

Dodaje określoną zawartość jako elementy podrzędne tego elementu XContainer .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 elementu XObject .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 mają zgodne XName .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 elementu XObject .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 elementu XObject .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()

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

(Odziedziczone po XNode)
CreateReader(ReaderOptions)

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

(Odziedziczone po XNode)
CreateWriter()

Tworzy XmlWriter , który może służyć do dodawania węzłów do XContainer .Creates 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 mają zgodne XName .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 mają zgodne XName .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 mają zgodne XName .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 mają zgodne XName .Only elements that have a matching XName are included in the collection.

(Odziedziczone po XNode)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.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żące wystąpienie.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 z TextReader .Creates a new XDocument from a TextReader.

Load(TextReader, LoadOptions)

Tworzy nową XDocument z TextReader , 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 z XmlReader .Creates a new XDocument from an XmlReader.

Load(XmlReader, LoadOptions)

Ładuje XDocument XmlReader program z, 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 elementu 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ą wartość XDocument z ciągu.Creates a new XDocument from a string.

Parse(String, LoadOptions)

Tworzy nową wartość XDocument 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 elementu XObject .Removes the annotations of the specified type from this XObject.

(Odziedziczone po XObject)
RemoveAnnotations<T>()

Usuwa adnotacje określonego typu z tego elementu XObject .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 wynik XDocument do określonego Stream .Outputs this XDocument to the specified Stream.

Save(Stream, SaveOptions)

Wyprowadza ten wynik XDocument 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 elementu XDocument do pliku, opcjonalnie wyłączenie formatowania.Serialize this XDocument to a file, optionally disabling formatting.

Save(TextWriter)

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

Save(TextWriter, SaveOptions)

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

Save(XmlWriter)

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

SaveAsync(Stream, SaveOptions, CancellationToken)

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

SaveAsync(TextWriter, SaveOptions, CancellationToken)

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

SaveAsync(XmlWriter, CancellationToken)

Zapisuje to XDocument w XmlWriter .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.

WriteToAsync(XmlWriter, CancellationToken)

Zapisuje bieżący węzeł do XmlWriter .Writes the current node to an XmlWriter.

(Odziedziczone po XNode)

Zdarzenia

Changed

Uruchamiany po XObject zmianie 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 ten XObject 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 XObject ma ona 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 elementu XObject .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 elementu XObject .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 w XmlSchemaSet .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 w XmlSchemaSet , 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 XPathNavigator dla elementu XNode .Creates an XPathNavigator for an XNode.

CreateNavigator(XNode, XmlNameTable)

Tworzy XPathNavigator dla elementu XNode .Creates an XPathNavigator for an XNode. XmlNameTableZapewnia 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 XElement wyrażenie using XPath.Selects an XElement using a XPath expression.

XPathSelectElement(XNode, String, IXmlNamespaceResolver)

Wybiera XElement wyrażenie using XPath, rozwiązując prefiksy przestrzeni nazw przy użyciu określonego elementu IXmlNamespaceResolver .Selects 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 elementu IXmlNamespaceResolver .Selects a collection of elements using an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver.

ToXPathNavigable(XNode)

Zwraca metodę dostępu, która umożliwia nawigowanie i edytowanie określonego elementu XNode .Returns an accessor that allows you to navigate and edit the specified XNode.

Dotyczy

Zobacz też