System::Xml::XmlDocument::CreateXmlDeclaration método

XmlDocument::CreateXmlDeclaration method

Crea un nodo XmlDeclaration con los valores especificados.

virtual SharedPtr<XmlDeclaration> System::Xml::XmlDocument::CreateXmlDeclaration(const String &version, const String &encoding, const String &standalone)
ParámetroTipoDescripción
versiónconst String&La versión debe ser “1.0”.
encodingconst String&El valor del atributo de codificación. Esta es la codificación que se utiliza al guardar el XmlDocument en un archivo o un flujo; por lo tanto, debe establecerse en una cadena compatible con la clase Text::Encoding, de lo contrario “XmlDocument::Save(String)” falla. Si es nullptr o String::Empty, el método XmlDocument::Save no escribe un atributo de codificación en la declaración XML y, por lo tanto, se utiliza la codificación predeterminada, UTF-8.
standaloneconst String&El valor debe ser “yes” o “no”. Si es nullptr o String::Empty, el método XmlDocument::Save no escribe un atributo standalone en la declaración XML.

ReturnValue

El nuevo nodo XmlDeclaration.

Observaciones

Nota: Si el XmlDocument se guarda en un TextWriter o en un XmlTextWriter, este valor de codificación se descarta. En su lugar, se utiliza la codificación del TextWriter o del XmlTextWriter. Esto garantiza que el XML generado pueda leerse nuevamente con la codificación correcta.

Ver también