XDocument Klass

Definition

Namnområde:

System.Xml.Linq

Sammansättning:

System.Xml.Linq.dll

Representerar ett XML-dokument. Information om komponenter och användning av ett XDocument objekt finns i Översikt över XDocument-klass.

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

Arv

Object

XObject

XNode

XContainer

XDocument

Exempel

I följande exempel skapas ett dokument och sedan läggs en kommentar och ett element till. Det skapar sedan ett annat dokument med hjälp av resultatet av en fråga.

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)

Det här exemplet genererar följande utdata:

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

Kommentarer

Mer information om det giltiga innehållet i en XDocumentfinns i Giltigt innehåll för XElement- och XDocument-objekt.

Konstruktorer

Name	Description
XDocument()	Initierar en ny instans av XDocument klassen.
XDocument(Object[])	Initierar en ny instans av XDocument klassen med det angivna innehållet.
XDocument(XDeclaration, Object[])	Initierar en ny instans av XDocument klassen med angivet XDeclaration innehåll och innehåll.
XDocument(XDocument)	Initierar en ny instans av XDocument klassen från ett befintligt XDocument objekt.

Egenskaper

Name	Description
BaseUri	Hämtar bas-URI:n för detta XObject. (Ärvd från XObject)
Declaration	Hämtar eller anger XML-deklarationen för det här dokumentet.
Document	XDocument Hämtar för detta XObject. (Ärvd från XObject)
DocumentType	Hämtar dokumenttypsdefinitionen (DTD) för det här dokumentet.
FirstNode	Hämtar den första underordnade noden för den här noden. (Ärvd från XContainer)
LastNode	Hämtar den sista underordnade noden för den här noden. (Ärvd från XContainer)
NextNode	Hämtar nästa nod på samma nivå för den här noden. (Ärvd från XNode)
NodeType	Hämtar nodtypen för den här noden.
Parent	Hämtar överordnad XElement för den här XObject. (Ärvd från XObject)
PreviousNode	Hämtar den tidigare syskonnoden för den här noden. (Ärvd från XNode)
Root	Hämtar rotelementet i XML-trädet för det här dokumentet.

Metoder

Name	Description
Add(Object)	Lägger till det angivna innehållet som underordnade till detta XContainer. (Ärvd från XContainer)
Add(Object[])	Lägger till det angivna innehållet som underordnade till detta XContainer. (Ärvd från XContainer)
AddAfterSelf(Object)	Lägger till det angivna innehållet direkt efter den här noden. (Ärvd från XNode)
AddAfterSelf(Object[])	Lägger till det angivna innehållet direkt efter den här noden. (Ärvd från XNode)
AddAnnotation(Object)	Lägger till ett objekt i anteckningslistan för den här XObject. (Ärvd från XObject)
AddBeforeSelf(Object)	Lägger till det angivna innehållet omedelbart före den här noden. (Ärvd från XNode)
AddBeforeSelf(Object[])	Lägger till det angivna innehållet omedelbart före den här noden. (Ärvd från XNode)
AddFirst(Object)	Lägger till det angivna innehållet som de första underordnade i det här dokumentet eller elementet. (Ärvd från XContainer)
AddFirst(Object[])	Lägger till det angivna innehållet som de första underordnade i det här dokumentet eller elementet. (Ärvd från XContainer)
Ancestors()	Returnerar en samling av de överordnade elementen i den här noden. (Ärvd från XNode)
Ancestors(XName)	Returnerar en filtrerad samling av de överordnade elementen i den här noden. Endast element som har matchning XName ingår i samlingen. (Ärvd från XNode)
Annotation(Type)	Hämtar det första anteckningsobjektet av den angivna typen från den här XObject. (Ärvd från XObject)
Annotation<T>()	Hämtar det första anteckningsobjektet av den angivna typen från den här XObject. (Ärvd från XObject)
Annotations(Type)	Hämtar en samling anteckningar av den angivna typen för den här XObject. (Ärvd från XObject)
Annotations<T>()	Hämtar en samling anteckningar av den angivna typen för den här XObject. (Ärvd från XObject)
CreateReader()	Skapar en XmlReader för den här noden. (Ärvd från XNode)
CreateReader(ReaderOptions)	Skapar en XmlReader med de alternativ som anges av parametern readerOptions . (Ärvd från XNode)
CreateWriter()	Skapar en XmlWriter som kan användas för att lägga till noder i XContainer. (Ärvd från XContainer)
DescendantNodes()	Returnerar en samling underordnade noder för det här dokumentet eller elementet i dokumentordning. (Ärvd från XContainer)
Descendants()	Returnerar en samling underordnade element för det här dokumentet eller elementet i dokumentordning. (Ärvd från XContainer)
Descendants(XName)	Returnerar en filtrerad samling av underordnade element för det här dokumentet eller elementet i dokumentordning. Endast element som har matchning XName ingår i samlingen. (Ärvd från XContainer)
Element(XName)	Hämtar det första underordnade elementet (i dokumentordning) med angivet XName. (Ärvd från XContainer)
Elements()	Returnerar en samling underordnade element i det här elementet eller dokumentet i dokumentordning. (Ärvd från XContainer)
Elements(XName)	Returnerar en filtrerad samling av de underordnade elementen i det här elementet eller dokumentet i dokumentordning. Endast element som har matchning XName ingår i samlingen. (Ärvd från XContainer)
ElementsAfterSelf()	Returnerar en samling av syskonelementen efter den här noden i dokumentordning. (Ärvd från XNode)
ElementsAfterSelf(XName)	Returnerar en filtrerad samling av syskonelementen efter den här noden i dokumentordning. Endast element som har matchning XName ingår i samlingen. (Ärvd från XNode)
ElementsBeforeSelf()	Returnerar en samling av syskonelementen före den här noden i dokumentordning. (Ärvd från XNode)
ElementsBeforeSelf(XName)	Returnerar en filtrerad samling av syskonelementen före den här noden i dokumentordning. Endast element som har matchning XName ingår i samlingen. (Ärvd från XNode)
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
IsAfter(XNode)	Avgör om den aktuella noden visas efter en angiven nod när det gäller dokumentordning. (Ärvd från XNode)
IsBefore(XNode)	Avgör om den aktuella noden visas före en angiven nod när det gäller dokumentordning. (Ärvd från XNode)
Load(Stream, LoadOptions)	Skapar en ny XDocument instans med hjälp av den angivna strömmen, om du vill bevara tomt utrymme, ange bas-URI och behålla radinformation.
Load(Stream)	Skapar en ny XDocument instans med hjälp av den angivna strömmen.
Load(String, LoadOptions)	Skapar en ny XDocument från en fil, om du vill bevara tomt utrymme, ange bas-URI och behålla radinformation.
Load(String)	Skapar en ny XDocument från en fil.
Load(TextReader, LoadOptions)	Skapar en ny XDocument från en TextReader, om du vill bevara tomt utrymme, ange bas-URI och behålla radinformation.
Load(TextReader)	Skapar en ny XDocument från en TextReader.
Load(XmlReader, LoadOptions)	Läser in en XDocument från en XmlReader, om du vill ange bas-URI:n och behålla radinformation.
Load(XmlReader)	Skapar en ny XDocument från en XmlReader.
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
Nodes()	Returnerar en samling av de underordnade noderna i det här elementet eller dokumentet i dokumentordning. (Ärvd från XContainer)
NodesAfterSelf()	Returnerar en samling av syskonnoderna efter den här noden i dokumentordning. (Ärvd från XNode)
NodesBeforeSelf()	Returnerar en samling av syskonnoderna före den här noden i dokumentordning. (Ärvd från XNode)
Parse(String, LoadOptions)	Skapar en ny XDocument från en sträng, om du vill bevara tomt utrymme, ange bas-URI och behålla radinformation.
Parse(String)	Skapar en ny XDocument från en sträng.
Remove()	Tar bort den här noden från den överordnade noden. (Ärvd från XNode)
RemoveAnnotations(Type)	Tar bort anteckningarna av den angivna typen från den här XObject. (Ärvd från XObject)
RemoveAnnotations<T>()	Tar bort anteckningarna av den angivna typen från den här XObject. (Ärvd från XObject)
RemoveNodes()	Tar bort de underordnade noderna från det här dokumentet eller elementet. (Ärvd från XContainer)
ReplaceNodes(Object)	Ersätter underordnade noder i det här dokumentet eller elementet med det angivna innehållet. (Ärvd från XContainer)
ReplaceNodes(Object[])	Ersätter underordnade noder i det här dokumentet eller elementet med det angivna innehållet. (Ärvd från XContainer)
ReplaceWith(Object)	Ersätter den här noden med det angivna innehållet. (Ärvd från XNode)
ReplaceWith(Object[])	Ersätter den här noden med det angivna innehållet. (Ärvd från XNode)
Save(Stream, SaveOptions)	Matar ut detta XDocument till angivet Stream, om du vill ange formateringsbeteende.
Save(Stream)	Matar ut detta XDocument till den angivna Stream.
Save(String, SaveOptions)	Serialisera detta XDocument till en fil, om du vill inaktivera formatering.
Save(String)	Serialisera detta XDocument till en fil och skriv över en befintlig fil om den finns.
Save(TextWriter, SaveOptions)	Serialisera detta XDocument till en TextWriter, om du vill inaktivera formatering.
Save(TextWriter)	Serialisera detta XDocument till en TextWriter.
Save(XmlWriter)	Serialisera detta XDocument till en XmlWriter.
ToString()	Returnerar den indragna XML-koden för den här noden. (Ärvd från XNode)
ToString(SaveOptions)	Returnerar XML för den här noden, om du vill inaktivera formatering. (Ärvd från XNode)
WriteTo(XmlWriter)	Skriv det här dokumentet till en XmlWriter.

Händelser

Name	Description
Changed	Upphöjt när den här XObject eller någon av dess underordnade har ändrats. (Ärvd från XObject)
Changing	Upphöjt när den här XObject eller någon av dess underordnade är på väg att ändras. (Ärvd från XObject)

Explicita gränssnittsimplementeringar

Name	Description
IXmlLineInfo.HasLineInfo()	Hämtar ett värde som anger om det här XObject innehåller radinformation eller inte. (Ärvd från XObject)
IXmlLineInfo.LineNumber	Hämtar det radnummer som den underliggande XmlReader rapporterade för den här XObject. (Ärvd från XObject)
IXmlLineInfo.LinePosition	Hämtar den radposition som den underliggande XmlReader rapporterade för detta XObject. (Ärvd från XObject)

Tilläggsmetoder

Name	Description
CreateNavigator(XNode, XmlNameTable)	Skapar en XPathNavigator för en XNode. Möjliggör XmlNameTable effektivare XPath-uttrycksbearbetning.
CreateNavigator(XNode)	Skapar en XPathNavigator för en XNode.
ToXPathNavigable(XNode)	Returnerar en accessor som gör att du kan navigera och redigera den angivna XNode.
Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)	Verifierar att en XDocument överensstämmer med en XSD i ett XmlSchemaSet, om du vill fylla i XML-trädet med post-schema-validation infoset (PSVI).
Validate(XDocument, XmlSchemaSet, ValidationEventHandler)	Den här metoden verifierar att en XDocument överensstämmer med en XSD i en XmlSchemaSet.
XPathEvaluate(XNode, String, IXmlNamespaceResolver)	Utvärderar ett XPath-uttryck och löser namnområdesprefix med hjälp av den angivna IXmlNamespaceResolver.
XPathEvaluate(XNode, String)	Utvärderar ett XPath-uttryck.
XPathSelectElement(XNode, String, IXmlNamespaceResolver)	Väljer ett XElement XPath-uttryck som matchar namnområdesprefix med hjälp av den angivna IXmlNamespaceResolver.
XPathSelectElement(XNode, String)	Väljer ett XElement XPath-uttryck.
XPathSelectElements(XNode, String, IXmlNamespaceResolver)	Väljer en samling element med ett XPath-uttryck som matchar namnområdesprefix med hjälp av den angivna IXmlNamespaceResolver.
XPathSelectElements(XNode, String)	Väljer en samling element med ett XPath-uttryck.

Se även

• XNamespace
• XDeclaration
• XElement
• XNode
• Översikt över LINQ till XML
• Översikt över XDocument-klass