XDocument Sınıf

Tanım

Ad Alanı:

System.Xml.Linq

Bütünleştirilmiş Kod:

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 XDocumentöğesinin geçerli içeriği hakkında ayrıntılı bilgi için bkz. Geçerli XElement ve XDocument Nesnelerinin İçeriği.

Oluşturucular

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 XDeclaration ve içeriğiyle sınıfının yeni bir örneğini XDocument başlatır.
XDocument(XDocument)	Mevcut XDocument bir nesneden sınıfının yeni bir örneğini XDocument başlatır.

Özellikler

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 XObjectiçin öğesini XDocument alır. (Devralındığı yer: XObject)
DocumentType	Bu belgenin 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 bir sonraki eşdüzey düğümünü alır. (Devralındığı yer: XNode)
NodeType	Bu düğümün düğüm türünü alır.
Parent	Bu XObjectöğesinin üst XElement öğesini 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

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üğümün hemen arkasına ekler. (Devralındığı yer: XNode)
AddAfterSelf(Object[])	Belirtilen içeriği bu düğümün hemen arkasına ekler. (Devralındığı yer: XNode)
AddAnnotation(Object)	Bu XObjectöğesinin ek açıklama listesine bir nesnesi ekler. (Devralındığı yer: XObject)
AddBeforeSelf(Object)	Belirtilen içeriği bu düğümün hemen önüne ekler. (Devralındığı yer: XNode)
AddBeforeSelf(Object[])	Belirtilen içeriği bu düğümün hemen önüne 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 öğelerinden oluşan bir koleksiyon döndürür. (Devralındığı yer: XNode)
Ancestors(XName)	Bu düğümün üst öğelerinin filtrelenmiş bir koleksiyonunu döndürür. Yalnızca eşleştirmesi XName olan öğ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ürdeki ek açıklamaların koleksiyonunu alır. (Devralındığı yer: XObject)
Annotations<T>()	Bu XObjectiçin belirtilen türdeki ek açıklamaların koleksiyonunu 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 readerOptions belirtilen seçeneklerle bir XmlReader oluşturur. (Devralındığı yer: XNode)
CreateWriter()	öğesine düğüm XContainereklemek için kullanılabilecek bir XmlWriter 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ştirmesi XName olan öğeler koleksiyona dahil edilir. (Devralındığı yer: XContainer)
Element(XName)	Belirtilen XNameöğesine sahip 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ştirmesi XName olan öğ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ştirmesi XName olan öğeler koleksiyona dahil edilir. (Devralındığı yer: XNode)
ElementsBeforeSelf()	Bu düğümden önceki eşdüzey öğelerden oluşan bir koleksiyonu 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ştirmesi XName olan öğ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()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
IsAfter(XNode)	Geçerli düğümün belirtilen bir düğümden sonra belge sırasına göre görünüp görünmediğini belirler. (Devralındığı yer: XNode)
IsBefore(XNode)	Geçerli düğümün belirtilen bir düğümden önce görüntülenip görüntülenmediğini belge sırasına göre belirler. (Devralındığı yer: XNode)
Load(Stream)	Belirtilen akışı kullanarak yeni XDocument bir örnek oluşturur.
Load(Stream, LoadOptions)	Belirtilen akışı kullanarak, isteğe bağlı olarak boşluğu koruyarak, temel URI'yi ayarlayarak ve satır bilgilerini koruyarak yeni XDocument bir örnek oluşturur.
Load(String)	Bir dosyadan yeni XDocument bir oluşturur.
Load(String, LoadOptions)	İsteğe bağlı olarak boşlukları koruyarak, temel URI'yi ayarlayarak ve satır bilgilerini koruyarak dosyadan yeni XDocument bir dosya oluşturur.
Load(TextReader)	sürümünden yeni XDocument bir TextReaderoluşturur.
Load(TextReader, LoadOptions)	bir 'den TextReaderyeni XDocument bir oluşturur; isteğe bağlı olarak boşluğu korur, temel URI'yi ayarlar ve satır bilgilerini korur.
Load(XmlReader)	sürümünden yeni XDocument bir XmlReaderoluşturur.
Load(XmlReader, LoadOptions)	XDocument bir 'den XmlReaderbir yükler, isteğe bağlı olarak temel URI'yi ayarlar ve satır bilgilerini korur.
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şluğu 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şluğu korur.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Belirtilen XmlReaderöğesinin içeriğini içeren yeni XDocument bir oluşturur.
MemberwiseClone()	Geçerli Objectöğesinin sığ 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üğümlerin bir koleksiyonunu belge sırasına göre döndürür. (Devralındığı yer: XNode)
NodesBeforeSelf()	Bu düğümden önceki eşdüzey düğümlerin koleksiyonunu belge sırasına göre döndürür. (Devralındığı yer: XNode)
Parse(String)	Bir dizeden yeni XDocument bir oluşturur.
Parse(String, LoadOptions)	İsteğe bağlı olarak boşluğu koruyarak, temel URI'yi ayarlayarak ve satır bilgilerini koruyarak 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 XObjectöğesinin içinden kaldırır. (Devralındığı yer: XObject)
RemoveAnnotations<T>()	Belirtilen türün ek açıklamalarını bu XObjectöğesinin iç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)	Bunu XDocument belirtilen Streamöğesine döndürür.
Save(Stream, SaveOptions)	Bunu XDocument , isteğe bağlı olarak biçimlendirme davranışını belirterek belirtilen Streamöğesine aktarır.
Save(String)	Varsa, varolan bir dosyanın üzerine yazarak bunu XDocument bir dosyaya seri hale getirin.
Save(String, SaveOptions)	Bunu XDocument bir dosyaya seri hale getirerek isteğe bağlı olarak biçimlendirmeyi devre dışı bırak.
Save(TextWriter)	Bunu XDocument bir TextWriterolarak serileştirin.
Save(TextWriter, SaveOptions)	Bunu XDocument bir TextWriterolarak seri hale getirerek isteğe bağlı olarak biçimlendirmeyi devre dışı bırak.
Save(XmlWriter)	Bunu XDocument bir XmlWriterolarak seri hale getirme.
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 döndürür. (Devralındığı yer: XNode)
ToString(SaveOptions)	Bu düğüm için XML'yi döndürür ve isteğe bağlı olarak biçimlendirmeyi devre dışı bırakır. (Devralındığı yer: XNode)
WriteTo(XmlWriter)	Bu belgeyi bir XmlWriteröğesine yazın.
WriteToAsync(XmlWriter, CancellationToken)	Bu XDocument'ın temel alınan XML ağacını belirtilen XmlWriteröğesine yazar.

Ekinlikler

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

Belirtik Arabirim Kullanımları

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

Uzantı Metotları

Validate(XDocument, XmlSchemaSet, ValidationEventHandler)	Bu yöntem, içindeki bir XDocument XSD'ye XmlSchemaSetuygun olduğunu doğrular.
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.
CreateNavigator(XNode)	için bir XPathNavigatorXNodeoluşturur.
CreateNavigator(XNode, XmlNameTable)	için bir XPathNavigatorXNodeoluşturur. , XmlNameTable daha verimli XPath ifade işlemeyi etkinleştirir.
XPathEvaluate(XNode, String)	XPath ifadesini değerlendirir.
XPathEvaluate(XNode, String, IXmlNamespaceResolver)	Belirtilen IXmlNamespaceResolverkullanarak ad alanı ön eklerini çözerek bir XPath ifadesini değerlendirir.
XPathSelectElement(XNode, String)	XPath ifadesi kullanarak bir XElement seçer.
XPathSelectElement(XNode, String, IXmlNamespaceResolver)	Belirtilen IXmlNamespaceResolverkullanılarak ad alanı ön eklerini çözümleyerek bir XPath ifadesi kullanarak bir XElement seçer.
XPathSelectElements(XNode, String)	XPath ifadesi kullanarak bir öğe koleksiyonu seçer.
XPathSelectElements(XNode, String, IXmlNamespaceResolver)	Belirtilen kullanılarak ad alanı ön eklerini çözümleyerek XPath ifadesi kullanan IXmlNamespaceResolverbir öğe koleksiyonunu seçer.
ToXPathNavigable(XNode)	Belirtilen XNodeöğesine gitmenize ve bunları düzenlemenize olanak tanıyan bir erişimci döndürür.

Ayrıca bkz.

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