## XmlDocument::CreateXmlDeclaration method


Creates an [XmlDeclaration](../../xmldeclaration/) node with the specified values.

```cpp
virtual SharedPtr<XmlDeclaration> System::Xml::XmlDocument::CreateXmlDeclaration(const String &version, const String &encoding, const String &standalone)
```


| Parameter | Type | Description |
| --- | --- | --- |
| version | const String\& | The version must be "1.0". |
| encoding | const String\& | The value of the encoding attribute. This is the encoding that is used when you save the [XmlDocument](../) to a file or a stream; therefore, it must be set to a string supported by the [Text::Encoding](../../../system.text/encoding/) class, otherwise "XmlDocument::Save(String)" fails. If this is **nullptr** or [String::Empty](../../../system/string/empty/), the [XmlDocument::Save](../save/) method does not write an encoding attribute on the XML declaration and therefore the default encoding, UTF-8, is used. |
| standalone | const String\& | The value must be either "yes" or "no". If this is **nullptr** or [String::Empty](../../../system/string/empty/), the [XmlDocument::Save](../save/) method does not write a standalone attribute on the XML declaration. |

### ReturnValue

The new [XmlDeclaration](../../xmldeclaration/) node.
## Remarks



Note: If the [XmlDocument](../) is saved to either a TextWriter or an [XmlTextWriter](../../xmltextwriter/), this encoding value is discarded. Instead, the encoding of the TextWriter or the [XmlTextWriter](../../xmltextwriter/) is used. This ensures that the XML written out can be read back using the correct encoding. 
## See Also

* Typedef [SharedPtr](../../../system/sharedptr/)
* Class [XmlDeclaration](../../xmldeclaration/)
* Class [String](../../../system/string/)
* Class [XmlDocument](../)
* Namespace [System::Xml](../../)
* Library [Aspose.PDF for C++](../../../)