Метод System::Xml::XmlDocument::CreateXmlDeclaration

XmlDocument::CreateXmlDeclaration method

Создаёт узел XmlDeclaration с указанными значениями.

virtual SharedPtr<XmlDeclaration> System::Xml::XmlDocument::CreateXmlDeclaration(const String &version, const String &encoding, const String &standalone)
ПараметрТипОписание
версияconst String&Версия должна быть “1.0”.
encodingconst String&Значение атрибута encoding. Это кодировка, которая используется при сохранении XmlDocument в файл или поток; поэтому её необходимо установить в строку, поддерживаемую классом Text::Encoding, иначе вызов “XmlDocument::Save(String)” завершится ошибкой. Если значение равно nullptr или String::Empty, метод XmlDocument::Save не записывает атрибут encoding в объявление XML и поэтому используется кодировка по умолчанию UTF-8.
standaloneconst String&Значение должно быть либо “yes”, либо “no”. Если оно равно nullptr или String::Empty, метод XmlDocument::Save не записывает атрибут standalone в объявление XML.

ReturnValue

Новый узел XmlDeclaration.

Примечания

Примечание: Если XmlDocument сохраняется в объект TextWriter или в XmlTextWriter, значение этой кодировки отбрасывается. Вместо этого используется кодировка TextWriter или XmlTextWriter. Это гарантирует, что записанный XML можно будет прочитать обратно с правильной кодировкой.

См. также