XMLSave (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / XML file functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

XMLSave (Function)

In french: XMLSauve

Saves an XML document in a file.

If an XSD description was used, it is automatically used to validate the XML document when saved.

Example

MonDocumentXML is xmlDocument
...
Filtre is string = "Fichiers XML (*.xml)" + TAB + "*.xml" + CR + ...
			"Tous fichiers (*.*)" + TAB + "*.*"
FichierSortie is string = fSelect("", "", "Sélectionnez un fichier XML ...", ...
			Filtre, "xml", fselCreate)
IF FichierSortie <>"" THEN
	XMLSave(MonDocumentXML, FichierSortie, XMLDocumentDefault)
	IF ErrorOccurred = True THEN
		ErrorBuild("Une erreur s'est produite pendant la sauvegarde : %1", ...
				ErrorInfo(errFullDetails))
	END
END

// La description du fichier XML nommé "flux" a été importée dans le projet. 
// Un ficher XML vierge va être créé à partir de cette description.
// Le ficher XML n'existe pas encore physiquement.
// Chargement du contenu XML
MonDocXML is xmlDocument,description="flux"
MonDocXML.rss.Channel[1].Title = gsParamTitre
MonDocXML.rss.Channel[1].Link = gsParamAdresseSite
MonDocXML.rss.Channel[1].Description = gsParamDescriptionSite
MonDocXML.rss.Channel[1].Copyright = gsParamCopyright
MonDocXML.rss.Channel[1].Webmaster = gsParamAdesseContact
MonDocXML.rss.Channel[1].Image = gsParamURLImageSite
MonDocXML.rss.Channel[1].Generator = "Easy RSS"
// Sauvegarde du fichier
XMLSave(MonDocXML, gsCheminFichierXML)
// Sauvegarde du fichier avec mise en forme (nouveauté 22)
XMLSave(MonDocXML, gsCheminFichierXML_Avec_MiseEnForme, XMLFormatting)

Syntax

XMLSave(<XML document> [, <File name and path>] [, <Options>])

<XML document>: xmlDocument variable

xmlDocument variable containing the document to save. This variable can be the result of a call to XMLOpen or it may have been declared and initialized directly.

<File name and path>: Optional ANSI or Unicode character string

Name and full (or relative) path of text file to create. A UNC path can be used.
If this parameter is not specified or if it is set to "" (empty string):
When XMLSave is called for the first time on this document, the XML document is saved to the location specified when it was opened (XMLOpen).
On subsequent calls to XMLSave, the XML document is saved to the location specified the last time it was saved.
An error occurs if the XML document was not opened by XMLOpen (opened from a URL, from a string or if the document was created).

<Options>: Optional Integer constant

Options for saving the XML document.
The possible values are:
XMLDocumentDefault
(default value) Saves the XML document with a header.
XMLFormatting Saves the XML document with formatting (indent and carriage returns).
XMLNoHeader Saves the XML document without header. This constant can be used when the XML document corresponds to a fragment of a more important document, concatenated with other XML documents thereafter.
xvNoValidation Saves the XML document without taking into account the XSD model specified when describing the XML document.

Remarks

When describing an XML document, you have the ability to specified the XSD file that will be used as validation model for the XML file. For example:

cMonDoc is xmlDocument <description="personne.xsd">

By default, this XSD file is taken into account when the document is saved: document validity is automatically checked before saving the XML document (equivalent to the XMLValidDocument function). If you don't want to perform this validation, simply use the constant xvWithoutValidation.

Business / UI classification: Business Logic

Component: wd300xml.dll