XDocument Sınıf

Tanım

Bir XML belgesini temsil eder.Represents an XML document. Bir nesnenin bileşenleri ve kullanımı için XDocument bkz. XDocument sınıfına genel bakış.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
Devralma

Örnekler

Aşağıdaki örnek bir belge oluşturur ve bu belgeye bir açıklama ve öğe ekler.The following example creates a document, and then adds a comment and an element to it. Daha sonra bir sorgunun sonuçlarını kullanarak başka bir belgeyi oluşturur.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)  

Bu örnek aşağıdaki çıktıyı üretir:This example produces the following output:

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

Açıklamalar

Öğesinin geçerli içeriğiyle ilgili ayrıntılar için XDocument bkz. XElement ve XDocument nesnelerinin geçerli içeriği.For details about the valid content of an XDocument, see Valid Content of XElement and XDocument Objects.

Oluşturucular

XDocument()

XDocument sınıfının yeni bir örneğini başlatır.Initializes a new instance of the XDocument class.

XDocument(Object[])

Belirtilen içerikle sınıfının yeni bir örneğini başlatır XDocument .Initializes a new instance of the XDocument class with the specified content.

XDocument(XDeclaration, Object[])

XDocumentBelirtilen ve içeriğiyle sınıfının yeni bir örneğini başlatır XDeclaration .Initializes a new instance of the XDocument class with the specified XDeclaration and content.

XDocument(XDocument)

Varolan bir nesneden sınıfının yeni bir örneğini başlatır XDocument XDocument .Initializes a new instance of the XDocument class from an existing XDocument object.

Özellikler

BaseUri

Bunun için temel URI 'yi alır XObject .Gets the base URI for this XObject.

(Devralındığı yer: XObject)
Declaration

Bu belgenin XML bildirimini alır veya ayarlar.Gets or sets the XML declaration for this document.

Document

XDocumentBunu için alır XObject .Gets the XDocument for this XObject.

(Devralındığı yer: XObject)
DocumentType

Bu belge için belge türü tanımını (DTD) alır.Gets the Document Type Definition (DTD) for this document.

FirstNode

Bu düğümün ilk alt düğümünü alır.Gets the first child node of this node.

(Devralındığı yer: XContainer)
LastNode

Bu düğümün son alt düğümünü alır.Gets the last child node of this node.

(Devralındığı yer: XContainer)
NextNode

Bu düğümün sonraki eşdüzey düğümünü alır.Gets the next sibling node of this node.

(Devralındığı yer: XNode)
NodeType

Bu düğüm için düğüm türünü alır.Gets the node type for this node.

Parent

Bunun üst öğesini alır XElement XObject .Gets the parent XElement of this XObject.

(Devralındığı yer: XObject)
PreviousNode

Bu düğümün önceki eşdüzey düğümünü alır.Gets the previous sibling node of this node.

(Devralındığı yer: XNode)
Root

Bu belge için XML ağacının kök öğesini alır.Gets the root element of the XML Tree for this document.

Yöntemler

Add(Object)

Belirtilen içeriği bunun alt öğeleri olarak ekler XContainer .Adds the specified content as children of this XContainer.

(Devralındığı yer: XContainer)
Add(Object[])

Belirtilen içeriği bunun alt öğeleri olarak ekler XContainer .Adds the specified content as children of this XContainer.

(Devralındığı yer: XContainer)
AddAfterSelf(Object)

Belirtilen içeriği bu düğümden hemen sonra ekler.Adds the specified content immediately after this node.

(Devralındığı yer: XNode)
AddAfterSelf(Object[])

Belirtilen içeriği bu düğümden hemen sonra ekler.Adds the specified content immediately after this node.

(Devralındığı yer: XNode)
AddAnnotation(Object)

Ek açıklama listesine bir nesne ekler XObject .Adds an object to the annotation list of this XObject.

(Devralındığı yer: XObject)
AddBeforeSelf(Object)

Belirtilen içeriği bu düğümden hemen önce ekler.Adds the specified content immediately before this node.

(Devralındığı yer: XNode)
AddBeforeSelf(Object[])

Belirtilen içeriği bu düğümden hemen önce ekler.Adds the specified content immediately before this node.

(Devralındığı yer: XNode)
AddFirst(Object)

Belirtilen içeriği bu belgenin veya öğenin ilk alt öğesi olarak ekler.Adds the specified content as the first children of this document or element.

(Devralındığı yer: XContainer)
AddFirst(Object[])

Belirtilen içeriği bu belgenin veya öğenin ilk alt öğesi olarak ekler.Adds the specified content as the first children of this document or element.

(Devralındığı yer: XContainer)
Ancestors()

Bu düğümün üst öğelerinin bir koleksiyonunu döndürür.Returns a collection of the ancestor elements of this node.

(Devralındığı yer: XNode)
Ancestors(XName)

Bu düğümün üst öğelerinin filtrelenmiş bir koleksiyonunu döndürür.Returns a filtered collection of the ancestor elements of this node. Yalnızca eşleşen öğeler XName koleksiyona dahil edilir.Only elements that have a matching XName are included in the collection.

(Devralındığı yer: XNode)
Annotation(Type)

Belirtilen türdeki ilk ek açıklama nesnesini bundan alır XObject .Gets the first annotation object of the specified type from this XObject.

(Devralındığı yer: XObject)
Annotation<T>()

Belirtilen türdeki ilk ek açıklama nesnesini bundan alır XObject .Gets the first annotation object of the specified type from this XObject.

(Devralındığı yer: XObject)
Annotations(Type)

Bu için belirtilen türdeki ek açıklamaların bir koleksiyonunu alır XObject .Gets a collection of annotations of the specified type for this XObject.

(Devralındığı yer: XObject)
Annotations<T>()

Bu için belirtilen türdeki ek açıklamaların bir koleksiyonunu alır XObject .Gets a collection of annotations of the specified type for this XObject.

(Devralındığı yer: XObject)
CreateReader()

XmlReaderBu düğüm için bir oluşturur.Creates an XmlReader for this node.

(Devralındığı yer: XNode)
CreateReader(ReaderOptions)

XmlReaderParametresi tarafından belirtilen seçeneklere sahip bir oluşturur readerOptions .Creates an XmlReader with the options specified by the readerOptions parameter.

(Devralındığı yer: XNode)
CreateWriter()

XmlWriterÖğesine düğüm eklemek için kullanılabilecek bir oluşturur XContainer .Creates an XmlWriter that can be used to add nodes to the XContainer.

(Devralındığı yer: XContainer)
DescendantNodes()

Belge düzeninde bu belge veya öğe için alt düğümlerin bir koleksiyonunu döndürür.Returns a collection of the descendant nodes for this document or element, in document order.

(Devralındığı yer: XContainer)
Descendants()

Belge düzeninde bu belge veya öğe için alt öğelerin bir koleksiyonunu döndürür.Returns a collection of the descendant elements for this document or element, in document order.

(Devralındığı yer: XContainer)
Descendants(XName)

Belge düzeninde, bu belge veya öğe için alt öğelerin filtrelenmiş bir koleksiyonunu döndürür.Returns a filtered collection of the descendant elements for this document or element, in document order. Yalnızca eşleşen öğeler XName koleksiyona dahil edilir.Only elements that have a matching XName are included in the collection.

(Devralındığı yer: XContainer)
Element(XName)

Belirtilen ilk (belge sırası) alt öğesini alır XName .Gets the first (in document order) child element with the specified XName.

(Devralındığı yer: XContainer)
Elements()

Belge düzeninde bu öğenin veya belgenin alt öğelerinin bir koleksiyonunu döndürür.Returns a collection of the child elements of this element or document, in document order.

(Devralındığı yer: XContainer)
Elements(XName)

Belge düzeninde bu öğenin veya belgenin alt öğelerinin filtrelenmiş bir koleksiyonunu döndürür.Returns a filtered collection of the child elements of this element or document, in document order. Yalnızca eşleşen öğeler XName koleksiyona dahil edilir.Only elements that have a matching XName are included in the collection.

(Devralındığı yer: XContainer)
ElementsAfterSelf()

Belge düzeninde, bu düğümden sonra eşdüzey öğelerin koleksiyonunu döndürür.Returns a collection of the sibling elements after this node, in document order.

(Devralındığı yer: XNode)
ElementsAfterSelf(XName)

Belge düzeninde, bu düğümden sonra eşdüzey öğelerin filtrelenmiş bir koleksiyonunu döndürür.Returns a filtered collection of the sibling elements after this node, in document order. Yalnızca eşleşen öğeler XName koleksiyona dahil edilir.Only elements that have a matching XName are included in the collection.

(Devralındığı yer: XNode)
ElementsBeforeSelf()

Belge düzeninde, bu düğümden önceki eşdüzey öğelerin koleksiyonunu döndürür.Returns a collection of the sibling elements before this node, in document order.

(Devralındığı yer: XNode)
ElementsBeforeSelf(XName)

Belge düzeninde, bu düğümden önce eşdüzey öğelerin filtrelenmiş bir koleksiyonunu döndürür.Returns a filtered collection of the sibling elements before this node, in document order. Yalnızca eşleşen öğeler XName koleksiyona dahil edilir.Only elements that have a matching XName are included in the collection.

(Devralındığı yer: XNode)
Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

(Devralındığı yer: Object)
GetType()

TypeGeçerli örneği alır.Gets the Type of the current instance.

(Devralındığı yer: Object)
IsAfter(XNode)

Geçerli düğümün belge sırası açısından belirtilen düğümden sonra görünüp görünmeyeceğini belirler.Determines if the current node appears after a specified node in terms of document order.

(Devralındığı yer: XNode)
IsBefore(XNode)

Geçerli düğümün belge sırası açısından belirtilen düğümden önce görünüp görünmeyeceğini belirler.Determines if the current node appears before a specified node in terms of document order.

(Devralındığı yer: XNode)
Load(Stream)

XDocumentBelirtilen akışı kullanarak yeni bir örnek oluşturur.Creates a new XDocument instance by using the specified stream.

Load(Stream, LoadOptions)

XDocumentBelirtilen akışı kullanarak, isteğe bağlı olarak boşluğu koruyarak, temel URI 'yi ayarlayarak ve satır bilgilerini koruyarak yeni bir örnek oluşturur.Creates a new XDocument instance by using the specified stream, optionally preserving white space, setting the base URI, and retaining line information.

Load(String)

Bir dosyadan yeni bir oluşturur XDocument .Creates a new XDocument from a file.

Load(String, LoadOptions)

XDocumentBir dosyadan yeni bir dosya oluşturur, isteğe bağlı olarak boşluk korur, temel URI 'yi ayarlar ve satır bilgilerini korur.Creates a new XDocument from a file, optionally preserving white space, setting the base URI, and retaining line information.

Load(TextReader)

Kaynağından yeni bir oluşturur XDocument TextReader .Creates a new XDocument from a TextReader.

Load(TextReader, LoadOptions)

XDocument TextReader , İsteğe bağlı olarak beyaz alanı koruyarak, temel URI 'yi ayarlayarak ve satır bilgilerini koruyarak yeni bir oluşturur.Creates a new XDocument from a TextReader, optionally preserving white space, setting the base URI, and retaining line information.

Load(XmlReader)

Kaynağından yeni bir oluşturur XDocument XmlReader .Creates a new XDocument from an XmlReader.

Load(XmlReader, LoadOptions)

Bir XDocument öğesinden bir yükler XmlReader , isteğe bağlı olarak temel URI 'yi ayarlar ve satır bilgilerini korur.Loads an XDocument from an XmlReader, optionally setting the base URI, and retaining line information.

LoadAsync(Stream, LoadOptions, CancellationToken)

Zaman uyumsuz olarak yeni bir oluşturur XDocument ve temel ALıNAN xml ağacını belirtilen akıştan başlatır ve isteğe bağlı olarak boşluk korunur.Asynchronously creates a new XDocument and initializes its underlying XML tree from the specified stream, optionally preserving white space.

LoadAsync(TextReader, LoadOptions, CancellationToken)

Yeni bir oluşturur XDocument ve belirtilen parametreyi kullanarak temel ALıNAN xml ağacını başlatır TextReader , isteğe bağlı olarak boşluğu korur.Creates a new XDocument and initializes its underlying XML tree using the specified TextReader parameter, optionally preserving white space.

LoadAsync(XmlReader, LoadOptions, CancellationToken)

XDocumentBelirtilen içeriğini içeren yeni bir oluşturur XmlReader .Creates a new XDocument containing the contents of the specified XmlReader.

MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
Nodes()

Belge düzeninde bu öğenin veya belgenin alt düğümlerinin bir koleksiyonunu döndürür.Returns a collection of the child nodes of this element or document, in document order.

(Devralındığı yer: XContainer)
NodesAfterSelf()

Bu düğümden sonra, belge düzeninde eşdüzey düğümlerin bir koleksiyonunu döndürür.Returns a collection of the sibling nodes after this node, in document order.

(Devralındığı yer: XNode)
NodesBeforeSelf()

Bu düğümden önce, belge düzeninde eşdüzey düğümlerin bir koleksiyonunu döndürür.Returns a collection of the sibling nodes before this node, in document order.

(Devralındığı yer: XNode)
Parse(String)

Bir dizeden yeni bir oluşturur XDocument .Creates a new XDocument from a string.

Parse(String, LoadOptions)

XDocumentBir dizeden yeni bir dize oluşturur, isteğe bağlı olarak boşluk korur, temel URI 'yi ayarlar ve satır bilgilerini korur.Creates a new XDocument from a string, optionally preserving white space, setting the base URI, and retaining line information.

Remove()

Bu düğümü üst öğesinden kaldırır.Removes this node from its parent.

(Devralındığı yer: XNode)
RemoveAnnotations(Type)

Belirtilen türün ek açıklamalarını bu öğesinden kaldırır XObject .Removes the annotations of the specified type from this XObject.

(Devralındığı yer: XObject)
RemoveAnnotations<T>()

Belirtilen türün ek açıklamalarını bu öğesinden kaldırır XObject .Removes the annotations of the specified type from this XObject.

(Devralındığı yer: XObject)
RemoveNodes()

Alt düğümleri bu belgeden veya öğeden kaldırır.Removes the child nodes from this document or element.

(Devralındığı yer: XContainer)
ReplaceNodes(Object)

Bu belgenin veya öğenin alt düğümlerini belirtilen içerikle değiştirir.Replaces the children nodes of this document or element with the specified content.

(Devralındığı yer: XContainer)
ReplaceNodes(Object[])

Bu belgenin veya öğenin alt düğümlerini belirtilen içerikle değiştirir.Replaces the children nodes of this document or element with the specified content.

(Devralındığı yer: XContainer)
ReplaceWith(Object)

Bu düğümü belirtilen içerikle değiştirir.Replaces this node with the specified content.

(Devralındığı yer: XNode)
ReplaceWith(Object[])

Bu düğümü belirtilen içerikle değiştirir.Replaces this node with the specified content.

(Devralındığı yer: XNode)
Save(Stream)

Bunu XDocument belirtilen şekilde verir Stream .Outputs this XDocument to the specified Stream.

Save(Stream, SaveOptions)

Bunu XDocument Stream , isteğe bağlı olarak biçimlendirme davranışını belirterek belirtilen şekilde verir.Outputs this XDocument to the specified Stream, optionally specifying formatting behavior.

Save(String)

Varsa, XDocument varolan bir dosyanın üzerine yazarak bunu bir dosyaya seri hale getirme.Serialize this XDocument to a file, overwriting an existing file, if it exists.

Save(String, SaveOptions)

Bunu XDocument , isteğe bağlı olarak biçimlendirmeyi devre dışı bırakarak bir dosyaya serileştirin.Serialize this XDocument to a file, optionally disabling formatting.

Save(TextWriter)

Bunu bir öğesine seri hale getirme XDocument TextWriter .Serialize this XDocument to a TextWriter.

Save(TextWriter, SaveOptions)

Bunu XDocument TextWriter , isteğe bağlı olarak biçimlendirmeyi devre dışı bırakarak bir olarak serileştirme.Serialize this XDocument to a TextWriter, optionally disabling formatting.

Save(XmlWriter)

Bunu bir öğesine seri hale getirme XDocument XmlWriter .Serialize this XDocument to an XmlWriter.

SaveAsync(Stream, SaveOptions, CancellationToken)

Bunu XDocument bir öğesine çıkış Stream .Output this XDocument to a Stream.

SaveAsync(TextWriter, SaveOptions, CancellationToken)

Bunu XDocument bir öğesine yazar TextWriter .Writes this XDocument to a TextWriter.

SaveAsync(XmlWriter, CancellationToken)

Bunu XDocument bir öğesine yazar XmlWriter .Writes this XDocument to an XmlWriter.

ToString()

Bu düğüm için girintili XML döndürür.Returns the indented XML for this node.

(Devralındığı yer: XNode)
ToString(SaveOptions)

Bu düğüm için XML döndürür ve isteğe bağlı olarak biçimlendirmeyi devre dışı bırakır.Returns the XML for this node, optionally disabling formatting.

(Devralındığı yer: XNode)
WriteTo(XmlWriter)

Bu belgeyi bir öğesine yazın XmlWriter .Write this document to an XmlWriter.

WriteToAsync(XmlWriter, CancellationToken)

Bu XDocument 'in temel alınan XML ağacını belirtilen öğesine yazar XmlWriter .Writes this XDocument's underlying XML tree to the specified XmlWriter.

WriteToAsync(XmlWriter, CancellationToken)

Geçerli düğümü bir öğesine yazar XmlWriter .Writes the current node to an XmlWriter.

(Devralındığı yer: XNode)

Ekinlikler

Changed

Bu XObject veya alt öğelerinden herhangi biri değiştiğinde tetiklenir.Raised when this XObject or any of its descendants have changed.

(Devralındığı yer: XObject)
Changing

Bu XObject veya alt öğelerinden herhangi biri değiştirmek üzere olduğunda tetiklenir.Raised when this XObject or any of its descendants are about to change.

(Devralındığı yer: XObject)

Belirtik Arabirim Kullanımları

IXmlLineInfo.HasLineInfo()

Bunun satır bilgilerine sahip olup olmadığını gösteren bir değer alır XObject .Gets a value indicating whether or not this XObject has line information.

(Devralındığı yer: XObject)
IXmlLineInfo.LineNumber

Temeldeki bu için raporlanan satır numarasını alır XmlReader XObject .Gets the line number that the underlying XmlReader reported for this XObject.

(Devralındığı yer: XObject)
IXmlLineInfo.LinePosition

Temeldeki bu için raporlanan satır konumunu alır XmlReader XObject .Gets the line position that the underlying XmlReader reported for this XObject.

(Devralındığı yer: XObject)

Uzantı Metotları

Validate(XDocument, XmlSchemaSet, ValidationEventHandler)

Bu yöntem XDocument , içindeki BIR xsd 'e uygun olduğunu doğrular XmlSchemaSet .This method validates that an XDocument conforms to an XSD in an XmlSchemaSet.

Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)

XDocument XmlSchemaSet , İsteğe bağlı olarak xml ağacını şema-doğrulama sonrası bilgi kümesi (PSVI) ile birlikte doldurmak IÇIN bir xsd öğesine uygun olduğunu doğrular.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)

Bir XPathNavigator için oluşturur XNode .Creates an XPathNavigator for an XNode.

CreateNavigator(XNode, XmlNameTable)

Bir XPathNavigator için oluşturur XNode .Creates an XPathNavigator for an XNode. XmlNameTableDaha verimli XPath ifadesi işlemesini sağlar.The XmlNameTable enables more efficient XPath expression processing.

XPathEvaluate(XNode, String)

Bir XPath ifadesini değerlendirir.Evaluates an XPath expression.

XPathEvaluate(XNode, String, IXmlNamespaceResolver)

Belirtilen ad alanı öneklerini çözümlemek için bir XPath ifadesi değerlendirir IXmlNamespaceResolver .Evaluates an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver.

XPathSelectElement(XNode, String)

XElementXPath ifadesi kullanarak seçer.Selects an XElement using a XPath expression.

XPathSelectElement(XNode, String, IXmlNamespaceResolver)

XElementBelirtilen ad alanı öneklerini bir XPath ifadesi kullanarak seçer IXmlNamespaceResolver .Selects an XElement using a XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver.

XPathSelectElements(XNode, String)

Bir XPath ifadesi kullanarak bir öğe koleksiyonu seçer.Selects a collection of elements using an XPath expression.

XPathSelectElements(XNode, String, IXmlNamespaceResolver)

Bir XPath ifadesi kullanarak bir öğe koleksiyonu seçer, belirtilen ad alanı öneklerini çözer IXmlNamespaceResolver .Selects a collection of elements using an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver.

ToXPathNavigable(XNode)

Belirtilen ' i gezinmenizi ve düzenlemenizi sağlayan bir erişimci döndürür XNode .Returns an accessor that allows you to navigate and edit the specified XNode.

Şunlara uygulanır

Ayrıca bkz.