XDocument Sınıf

Tanım

Ad Alanı:

System.Xml.Linq

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.XDocument.dll

Kaynak:

XDocument.cs

XML belgesini temsil eder. Bir XDocument nesnenin bileşenleri ve kullanımı için bkz. XDocument Sınıfına Genel Bakış.

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

Object

XObject

XNode

XContainer

XDocument

Örnekler

Aşağıdaki örnek bir belge oluşturur ve sonra buna bir açıklama ve öğe ekler. Ardından sorgunun sonuçlarını kullanarak başka bir belge oluşturur.

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 çıkışı oluşturur:

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

Açıklamalar

bir öğesinin geçerli içeriği XDocumenthakkında ayrıntılı bilgi için bkz. Geçerli XElement ve XDocument Nesnelerinin İçeriği.

Oluşturucular

Name	Description
XDocument()	XDocument sınıfının yeni bir örneğini başlatır.
XDocument(Object[])	Belirtilen içerikle sınıfının yeni bir örneğini XDocument başlatır.
XDocument(XDeclaration, Object[])	Belirtilen XDocument ve içeriğiyle sınıfının yeni bir örneğini XDeclaration başlatır.
XDocument(XDocument)	Mevcut XDocument bir nesneden sınıfının yeni bir örneğini XDocument başlatır.

Özellikler

Name	Description
BaseUri	Bu XObjectiçin temel URI'yi alır. (Devralındığı yer: XObject)
Declaration	Bu belge için XML bildirimini alır veya ayarlar.
Document	bunun XDocumentiçin öğesini XObject alır. (Devralındığı yer: XObject)
DocumentType	Bu belge için Belge Türü Tanımını (DTD) alır.
FirstNode	Bu düğümün ilk alt düğümünü alır. (Devralındığı yer: XContainer)
LastNode	Bu düğümün son alt düğümünü alır. (Devralındığı yer: XContainer)
NextNode	Bu düğümün sonraki eşdüzey düğümünü alır. (Devralındığı yer: XNode)
NodeType	Bu düğüm için düğüm türünü alır.
Parent	Bu XElementöğesinin üst öğesini XObject alır. (Devralındığı yer: XObject)
PreviousNode	Bu düğümün önceki eşdüzey düğümünü alır. (Devralındığı yer: XNode)
Root	Bu belge için XML Ağacı'nın kök öğesini alır.

Yöntemler

Name	Description
Add(Object)	Belirtilen içeriği bu XContaineröğesinin alt öğeleri olarak ekler. (Devralındığı yer: XContainer)
Add(Object[])	Belirtilen içeriği bu XContaineröğesinin alt öğeleri olarak ekler. (Devralındığı yer: XContainer)
AddAfterSelf(Object)	Belirtilen içeriği bu düğümden hemen sonra ekler. (Devralındığı yer: XNode)
AddAfterSelf(Object[])	Belirtilen içeriği bu düğümden hemen sonra ekler. (Devralındığı yer: XNode)
AddAnnotation(Object)	Bu XObjectek açıklama listesine bir nesne ekler. (Devralındığı yer: XObject)
AddBeforeSelf(Object)	Belirtilen içeriği bu düğümden hemen önce ekler. (Devralındığı yer: XNode)
AddBeforeSelf(Object[])	Belirtilen içeriği bu düğümden hemen önce ekler. (Devralındığı yer: XNode)
AddFirst(Object)	Belirtilen içeriği bu belgenin veya öğenin ilk alt öğeleri olarak ekler. (Devralındığı yer: XContainer)
AddFirst(Object[])	Belirtilen içeriği bu belgenin veya öğenin ilk alt öğeleri olarak ekler. (Devralındığı yer: XContainer)
Ancestors()	Bu düğümün üst öğelerinin bir koleksiyonunu döndürür. (Devralındığı yer: XNode)
Ancestors(XName)	Bu düğümün üst öğelerinin filtrelenmiş koleksiyonunu döndürür. Yalnızca eşleşen XName öğeler koleksiyona dahil edilir. (Devralındığı yer: XNode)
Annotation(Type)	Belirtilen türün ilk ek açıklama nesnesini bu XObjectöğesinden alır. (Devralındığı yer: XObject)
Annotation<T>()	Belirtilen türün ilk ek açıklama nesnesini bu XObjectöğesinden alır. (Devralındığı yer: XObject)
Annotations(Type)	Bu XObjectiçin belirtilen türde bir ek açıklama koleksiyonu alır. (Devralındığı yer: XObject)
Annotations<T>()	Bu XObjectiçin belirtilen türde bir ek açıklama koleksiyonu alır. (Devralındığı yer: XObject)
CreateReader()	Bu düğüm için bir XmlReader oluşturur. (Devralındığı yer: XNode)
CreateReader(ReaderOptions)	parametresi tarafından XmlReader belirtilen seçeneklerle bir readerOptions oluşturur. (Devralındığı yer: XNode)
CreateWriter()	öğesine düğüm XmlWritereklemek için kullanılabilecek bir XContainer oluşturur. (Devralındığı yer: XContainer)
DescendantNodes()	Bu belge veya öğe için belge sırasına göre alt düğümlerden oluşan bir koleksiyon döndürür. (Devralındığı yer: XContainer)
Descendants()	Bu belge veya öğe için belge sırasına göre alt öğe koleksiyonunu döndürür. (Devralındığı yer: XContainer)
Descendants(XName)	Bu belge veya öğe için, belge sırasına göre alt öğelerden oluşan filtrelenmiş bir koleksiyon döndürür. Yalnızca eşleşen XName öğeler koleksiyona dahil edilir. (Devralındığı yer: XContainer)
Element(XName)	Belirtilen XNameile ilk (belge sırasına göre) alt öğesini alır. (Devralındığı yer: XContainer)
Elements()	Bu öğenin veya belgenin alt öğelerinin bir koleksiyonunu belge sırasına göre döndürür. (Devralındığı yer: XContainer)
Elements(XName)	Bu öğenin veya belgenin alt öğelerinin filtrelenmiş koleksiyonunu belge sırasına göre döndürür. Yalnızca eşleşen XName öğeler koleksiyona dahil edilir. (Devralındığı yer: XContainer)
ElementsAfterSelf()	Bu düğümden sonraki eşdüzey öğelerden oluşan bir koleksiyonu belge sırasına göre döndürür. (Devralındığı yer: XNode)
ElementsAfterSelf(XName)	Bu düğümden sonraki eşdüzey öğelerin filtrelenmiş koleksiyonunu belge sırasına göre döndürür. Yalnızca eşleşen XName öğeler koleksiyona dahil edilir. (Devralındığı yer: XNode)
ElementsBeforeSelf()	Bu düğümden önceki eşdüzey öğelerin bir koleksiyonunu belge sırasına göre döndürür. (Devralındığı yer: XNode)
ElementsBeforeSelf(XName)	Bu düğümden önceki eşdüzey öğelerin filtrelenmiş koleksiyonunu belge sırasına göre döndürür. Yalnızca eşleşen XName öğeler koleksiyona dahil edilir. (Devralındığı yer: XNode)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
IsAfter(XNode)	Geçerli düğümün belge sırası açısından belirtilen bir düğümden sonra görünüp görünmediğini belirler. (Devralındığı yer: XNode)
IsBefore(XNode)	Geçerli düğümün belge sırası açısından belirtilen bir düğümden önce görünüp görünmediğini belirler. (Devralındığı yer: XNode)
Load(Stream, LoadOptions)	Belirtilen akışı kullanarak, isteğe bağlı olarak boşluk koruyarak, temel URI'yi ayarlayarak ve satır bilgilerini koruyarak yeni XDocument bir örnek oluşturur.
Load(Stream)	Belirtilen akışı kullanarak yeni XDocument bir örnek oluşturur.
Load(String, LoadOptions)	İsteğe bağlı olarak boşluk koruyarak, temel URI'yi ayarlayarak ve satır bilgilerini koruyarak dosyadan yeni XDocument bir dosya oluşturur.
Load(String)	Bir dosyadan yeni XDocument bir oluşturur.
Load(TextReader, LoadOptions)	bir sürümünden XDocumentyeni TextReader bir oluşturur; isteğe bağlı olarak boşluğu korur, temel URI'yi ayarlar ve satır bilgilerini korur.
Load(TextReader)	bir sürümünden yeni XDocument bir TextReaderoluşturur.
Load(XmlReader, LoadOptions)	bir 'den XDocumentbir XmlReader yükler, isteğe bağlı olarak temel URI'yi ayarlar ve satır bilgilerini korur.
Load(XmlReader)	bir sürümünden yeni XDocument bir XmlReaderoluşturur.
LoadAsync(Stream, LoadOptions, CancellationToken)	Zaman uyumsuz olarak yeni XDocument bir oluşturur ve belirtilen akıştan temel alınan XML ağacını başlatır ve isteğe bağlı olarak boşluk korur.
LoadAsync(TextReader, LoadOptions, CancellationToken)	Yeni XDocument bir oluşturur ve belirtilen TextReader parametreyi kullanarak temel alınan XML ağacını başlatır ve isteğe bağlı olarak boşluk korur.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Belirtilen XDocumentöğesinin içeriğini içeren yeni XmlReader bir oluşturur.
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
Nodes()	Bu öğenin veya belgenin alt düğümlerinin bir koleksiyonunu belge sırasına göre döndürür. (Devralındığı yer: XContainer)
NodesAfterSelf()	Bu düğümden sonraki eşdüzey düğümlerden oluşan bir koleksiyonu belge sırasına göre döndürür. (Devralındığı yer: XNode)
NodesBeforeSelf()	Bu düğümden önceki eşdüzey düğümlerin bir koleksiyonunu belge sırasına göre döndürür. (Devralındığı yer: XNode)
Parse(String, LoadOptions)	İsteğe bağlı olarak boşluk koruyarak, temel URI'yi ayarlayarak ve satır bilgilerini koruyarak bir dizeden yeni XDocument bir oluşturur.
Parse(String)	Bir dizeden yeni XDocument bir oluşturur.
Remove()	Bu düğümü üst öğesinden kaldırır. (Devralındığı yer: XNode)
RemoveAnnotations(Type)	Belirtilen türün ek açıklamalarını bu XObjectiçinden kaldırır. (Devralındığı yer: XObject)
RemoveAnnotations<T>()	Belirtilen türün ek açıklamalarını bu XObjectiçinden kaldırır. (Devralındığı yer: XObject)
RemoveNodes()	Bu belgeden veya öğeden alt düğümleri kaldırır. (Devralındığı yer: XContainer)
ReplaceNodes(Object)	Bu belgenin veya öğenin alt düğümlerini belirtilen içerikle değiştirir. (Devralındığı yer: XContainer)
ReplaceNodes(Object[])	Bu belgenin veya öğenin alt düğümlerini belirtilen içerikle değiştirir. (Devralındığı yer: XContainer)
ReplaceWith(Object)	Bu düğümü belirtilen içerikle değiştirir. (Devralındığı yer: XNode)
ReplaceWith(Object[])	Bu düğümü belirtilen içerikle değiştirir. (Devralındığı yer: XNode)
Save(Stream, SaveOptions)	Bunu XDocument , isteğe bağlı olarak biçimlendirme davranışını belirterek belirtilen Streamöğesine aktarır.
Save(Stream)	Bunu XDocument belirtilen Streamöğesine döndürür.
Save(String, SaveOptions)	Bunu XDocument bir dosyaya seri hale getirerek isteğe bağlı olarak biçimlendirmeyi devre dışı bırak.
Save(String)	Varsa, varolan bir dosyanın üzerine yazarak bunu XDocument bir dosyaya seri hale getirin.
Save(TextWriter, SaveOptions)	Bunu XDocument bir TextWriterolarak seri hale getirerek isteğe bağlı olarak biçimlendirmeyi devre dışı bırak.
Save(TextWriter)	Bunu XDocument bir TextWriterolarak seri hale getirme.
Save(XmlWriter)	Bunu XDocument bir XmlWriterolarak serileştirin.
SaveAsync(Stream, SaveOptions, CancellationToken)	Bunu XDocument bir öğesine çıkış olarak Streambelirleyin.
SaveAsync(TextWriter, SaveOptions, CancellationToken)	Bunu XDocument öğesine TextWriteryazar.
SaveAsync(XmlWriter, CancellationToken)	Bunu XDocument bir XmlWriteröğesine yazar.
ToString()	Bu düğüm için girintili XML'yi döndürür. (Devralındığı yer: XNode)
ToString(SaveOptions)	İsteğe bağlı olarak biçimlendirmeyi devre dışı bırakarak bu düğüm için XML döndürür. (Devralındığı yer: XNode)
WriteTo(XmlWriter)	Bu belgeyi bir XmlWriteröğesine yazın.
WriteToAsync(XmlWriter, CancellationToken)	Bu XDocument'ın temel xml ağacını belirtilen XmlWriteröğesine yazar.

Ekinlikler

Name	Description
Changed	Bu XObject veya alt öğelerinden herhangi biri değiştiğinde yükseltildi. (Devralındığı yer: XObject)
Changing	Bu XObject veya alt öğelerinden herhangi biri değişmek üzereyken yükseltilir. (Devralındığı yer: XObject)

Belirtik Arabirim Kullanımları

Name	Description
IXmlLineInfo.HasLineInfo()	Bunun XObject satır bilgilerine sahip olup olmadığını belirten bir değer alır. (Devralındığı yer: XObject)
IXmlLineInfo.LineNumber	Temel XmlReader alınanın bu XObjectiçin bildirdiği satır numarasını alır. (Devralındığı yer: XObject)
IXmlLineInfo.LinePosition	Temel XmlReader alınanın bu XObjectiçin bildirdiği satır konumunu alır. (Devralındığı yer: XObject)

Uzantı Metotları

Name	Description
CreateNavigator(XNode, XmlNameTable)	için bir XPathNavigatorXNodeoluşturur. , XmlNameTable daha verimli XPath ifade işlemeyi etkinleştirir.
CreateNavigator(XNode)	için bir XPathNavigatorXNodeoluşturur.
ToXPathNavigable(XNode)	Belirtilen XNodeiçinde gezinmenizi ve düzenlemenizi sağlayan bir erişimci döndürür.
Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)	içindeki bir XDocument XSD'ye XmlSchemaSetuygun olduğunu doğrular ve isteğe bağlı olarak XML ağacını şema doğrulama sonrası bilgi kümesi (PSVI) ile doldurur.
Validate(XDocument, XmlSchemaSet, ValidationEventHandler)	Bu yöntem, içindeki bir XDocument XSD'ye XmlSchemaSetuygun olduğunu doğrular.
XPathEvaluate(XNode, String, IXmlNamespaceResolver)	Belirtilen IXmlNamespaceResolverkullanarak ad alanı ön eklerini çözümleyerek bir XPath ifadesini değerlendirir.
XPathEvaluate(XNode, String)	XPath ifadesini değerlendirir.
XPathSelectElement(XNode, String, IXmlNamespaceResolver)	Belirtilen XElementkullanarak ad alanı ön eklerini çözümleyerek bir XPath ifadesi kullanarak bir IXmlNamespaceResolver seçer.
XPathSelectElement(XNode, String)	Bir XPath ifadesi kullanarak bir XElement seçer.
XPathSelectElements(XNode, String, IXmlNamespaceResolver)	Belirtilen IXmlNamespaceResolverkullanarak ad alanı ön eklerini çözümleyerek bir XPath ifadesi kullanarak bir öğe koleksiyonu seçer.
XPathSelectElements(XNode, String)	XPath ifadesi kullanarak bir öğe koleksiyonu seçer.

Ayrıca bkz.

• XNamespace
• XDeclaration
• XElement
• XNode
• LINQ to XML'e genel bakış
• XDocument Sınıfına Genel Bakış