System::Xml::XmlDocument::CreateXmlDeclaration-methode

XmlDocument::CreateXmlDeclaration method

Maakt een XmlDeclaration knooppunt met de opgegeven waarden.

virtual SharedPtr<XmlDeclaration> System::Xml::XmlDocument::CreateXmlDeclaration(const String &version, const String &encoding, const String &standalone)
ParameterTypeBeschrijving
versieconst String&De versie moet “1.0” zijn.
encodingconst String&De waarde van het coderingattribuut. Dit is de codering die wordt gebruikt wanneer u het XmlDocument opslaat naar een bestand of een stream; daarom moet het worden ingesteld op een tekenreeks die wordt ondersteund door de Text::Encoding klasse, anders faalt “XmlDocument::Save(String)”. Als dit nullptr of String::Empty is, schrijft de XmlDocument::Save methode geen coderingattribuut in de XML-declaratie en wordt daarom de standaardcodering, UTF-8, gebruikt.
standaloneconst String&De waarde moet “yes” of “no” zijn. Als dit nullptr of String::Empty is, schrijft de XmlDocument::Save methode geen standalone-attribuut in de XML-declaratie.

ReturnValue

Het nieuwe XmlDeclaration knooppunt.

Opmerkingen

Opmerking: Als het XmlDocument wordt opgeslagen naar een TextWriter of een XmlTextWriter, wordt deze coderingswaarde genegeerd. In plaats daarvan wordt de codering van de TextWriter of de XmlTextWriter gebruikt. Dit zorgt ervoor dat de geschreven XML correct kan worden gelezen met de juiste codering.

Zie ook