XDocument::Declaration Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets or sets the XML declaration for this document.

Namespace:   System.Xml.Linq
Assembly:  System.Xml.Linq (in System.Xml.Linq.dll)

public:
property XDeclaration^ Declaration {
	XDeclaration^ get();
	void set(XDeclaration^ value);
}

Property Value

Type: System.Xml.Linq::XDeclaration^

An XDeclaration that contains the XML declaration for this document.

Sometimes you have to create an XML declaration for a document. If you want to indicate that a document is standalone, you must use this property. If you want to encode your document with an encoding other than utf-8, you can specify an encoding through the XDeclaration. Another approach for encoding a document is to specify the encoding on an XmlWriter that you pass to LINQ to XML for writing.

The following example uses this property to retrieve the XML declaration of a document.

No code example is currently available or this language may not be supported.

This example produces the following output:


<?xml version="1.0" encoding="utf-8" standalone="yes"?>

Universal Windows Platform
Available since 8
.NET Framework
Available since 3.5
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: