System::Xml::XmlDocument::CreateXmlDeclaration-Methode

XmlDocument::CreateXmlDeclaration method

Erstellt einen XmlDeclaration-Knoten mit den angegebenen Werten.

virtual SharedPtr<XmlDeclaration> System::Xml::XmlDocument::CreateXmlDeclaration(const String &version, const String &encoding, const String &standalone)
ParameterTypBeschreibung
Versionconst String&Die Version muss “1.0” sein.
encodingconst String&Der Wert des Encoding-Attributs. Dies ist das Encoding, das verwendet wird, wenn Sie das XmlDocument in eine Datei oder einen Stream speichern; daher muss es auf eine von der Text::Encoding Klasse unterstützte Zeichenfolge gesetzt werden, sonst schlägt “XmlDocument::Save(String)” fehl. Wenn dies nullptr oder String::Empty ist, schreibt die Methode XmlDocument::Save kein Encoding-Attribut in die XML-Deklaration und es wird daher das Standard-Encoding UTF-8 verwendet.
standaloneconst String&Der Wert muss entweder “yes” oder “no” sein. Wenn dies nullptr oder String::Empty ist, schreibt die Methode XmlDocument::Save kein standalone-Attribut in die XML-Deklaration.

ReturnValue

Der neue XmlDeclaration Knoten.

Hinweise

Hinweis: Wenn das XmlDocument entweder in einen TextWriter oder einen XmlTextWriter gespeichert wird, wird dieser Encoding-Wert verworfen. Stattdessen wird das Encoding des TextWriter oder des XmlTextWriter verwendet. Dies stellt sicher, dass das ausgegebene XML mit dem korrekten Encoding wieder eingelesen werden kann.

Siehe auch