Méthode System::Xml::XmlDocument::CreateXmlDeclaration

XmlDocument::CreateXmlDeclaration method

Crée un nœud XmlDeclaration avec les valeurs spécifiées.

virtual SharedPtr<XmlDeclaration> System::Xml::XmlDocument::CreateXmlDeclaration(const String &version, const String &encoding, const String &standalone)
ParamètreTypeDescription
versionconst String&La version doit être “1.0”.
encodingconst String&La valeur de l’attribut d’encodage. Il s’agit de l’encodage utilisé lorsque vous enregistrez le XmlDocument dans un fichier ou un flux ; par conséquent, il doit être défini sur une chaîne prise en charge par la classe Text::Encoding, sinon “XmlDocument::Save(String)” échoue. Si c’est nullptr ou String::Empty, la méthode XmlDocument::Save n’écrit pas d’attribut d’encodage dans la déclaration XML et, par conséquent, l’encodage par défaut, UTF-8, est utilisé.
standaloneconst String&La valeur doit être soit “yes” soit “no”. Si c’est nullptr ou String::Empty, la méthode XmlDocument::Save n’écrit pas d’attribut standalone dans la déclaration XML.

ReturnValue

Le nouveau nœud XmlDeclaration.

Remarques

Remarque : si le XmlDocument est enregistré dans un TextWriter ou un XmlTextWriter, cette valeur d’encodage est ignorée. À la place, l’encodage du TextWriter ou du XmlTextWriter est utilisé. Cela garantit que le XML écrit peut être relu en utilisant le bon encodage.

Voir aussi