XDocument.Declaration Właściwość
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia deklarację XML dla tego dokumentu.
public:
property System::Xml::Linq::XDeclaration ^ Declaration { System::Xml::Linq::XDeclaration ^ get(); void set(System::Xml::Linq::XDeclaration ^ value); };public System.Xml.Linq.XDeclaration Declaration { get; set; }public System.Xml.Linq.XDeclaration? Declaration { get; set; }member this.Declaration : System.Xml.Linq.XDeclaration with get, setPublic Property Declaration As XDeclarationElement XDeclaration zawierający deklarację XML dla tego dokumentu.
W poniższym przykładzie użyto tej właściwości do pobrania deklaracji XML dokumentu.
XDocument doc = new XDocument(
new XDeclaration("1.0", "utf-8", "yes"),
new XComment("This is a comment"),
new XElement("Root", "content")
);
Console.WriteLine(doc.Declaration);
Dim doc As XDocument = _
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<!--This is a comment-->
<Root>content</Root>
Console.WriteLine(doc.Declaration)
Ten przykład generuje następujące wyniki:
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
Czasami trzeba utworzyć deklarację XML dla dokumentu. Jeśli chcesz wskazać, że dokument jest autonomiczny, musisz użyć tej właściwości. Jeśli chcesz zakodować dokument za pomocą kodowania innego niż utf-8, możesz określić kodowanie za pomocą polecenia XDeclaration. Innym podejściem do kodowania dokumentu jest określenie kodowania XmlWriter przekazywanego do LINQ to XML na potrzeby pisania.
| Produkt | Wersje |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 |
| .NET Framework | 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |