HListDatabase (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 / Managing databases / HFSQL / HFSQL Client/Server functions

HListDatabase and Native MySQL Connector

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

HListDatabase (Function)

In french: HListeBaseDeDonnées

Available only with these kinds of connection

Lists the Client/Server databases associated with a connection.

Lists the databases associated with a MySQL connection.

Example

// Description de la connexion
HDescribeConnection("MaConnexion", "Julie", "MotDePasse", ...
		"MonServeurHF", "", hAccessHFClientServer, hORead)
// Ouverture de la connexion
HOpenConnection("MaConnexion")
...
// Ajoute dans un champ de saisie les bases de données de la connexion "MaConnexion"
SAI_Saisie1 = HListDatabase("MaConnexion")

Syntax

<Result> = HListDatabase(<Connection> [, <Options>])

<Result>: Character string

List of databases of the server defined by the connection. The result is more or less detailed depending on the constant used:
hLstNormal Lists the databases of the server defined by the connection:
<Name of database 1> + TAB + <Name of database 2> + TAB + ...
hLstFile Lists the databases and their files for the server defined by the connection:
<Database Name 1> + TAB + <Data File Name 1 in Database 1> + TAB + ... + CR + <Database Name 2> + TAB + <Data File Name 1 in Database 2> + TAB + ... + CR + ...
hLstDatabaseSize Lists the databases and their size (in bytes) for the server defined by the connection:
<Name of database 1> + TAB + <Size of database 1> + CR + <Name of database 2> + TAB + <Size of database 2> + CR + ...
Not available.

Where:
<Nom de la base de données X> Database name.
<Nom du fichier de données Y dans la base de données X> Name of physical data file Y in database X.
<Taille de la base de données X> Size of all the files making up the database in bytes.
If an error occurs, the list of databases corresponds to an empty string ("") and HError is used to identify the error.

<Connection>: Character string or Connection variable

Connection to use. This connection corresponds to:
the name of the connection defined in the data model editor or with HDescribeConnection or HOpenConnection.
the name of a variable of type Connection.

<Options>: Optional Integer constant (or combination of constants)

Type of list to perform:
hLstFile Detailed list, used to find out the files associated with each database.
hLstNormal
(default value) Non-detailed list, containing the name of the databases associated with a connection.
hLstDatabaseSize Detailed list, used to find out the size of all the files associated with each database.
Not available.

Remarks

HListDatabase and Native MySQL Connector

HListFile returns the list of files found in the current database.
HListDatabase lists the accessible MySQL databases and their files.

Component: wd300hf.dll