Database (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage properties / HFSQL properties

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Database (Property)

In french: BaseDeDonnées

Not available with these kinds of connection

The Database property is used to manage databases associated with a connection (HFSQL Client/Server, OLE DB, etc.). You can:

Identify the database associated with a connection (HFSQL Client/Server, OLE DB, etc.).
Define the database associated with a connection (HFSQL Client/Server, OLE DB, etc.). In this case, when you open a file that uses an open connection, that connection will be closed and reopened with the new parameters.

Note: The connection can correspond:

a connection defined in the data model editor,
a connection defined with HConnect, HDescribeConnection or HOpenConnection.
a connection defined with a variable of type Connection.

Example

MyConnection is Connection
// Describe the connection
MyConnection.User = "USER"
MyConnection.Password = "PASSWORD"
MyConnection.Server = "MYSERVER" 
MyConnection.Database = "Test"
MyConnection.Provider = hAccessHFClientServer
MyConnection.Access = hOReadWrite
MyConnection.ExtendedInfo = "Extended information"
MyConnection.CursorOptions = hClientCursor

HOpenConnection(MyConnection)

Syntax

Identifying the database associated with a connection Hide the details

<Associated database> = <Connection>.Database

<Associated database>: Character string

Database used as data source for the connection.
Empty string ("") if no specific database is associated with the connection.

<Connection>: Name or variable of type Connection

Name of the connection used. This name is defined:
in the data model editor,
with the HDescribeConnection and HOpenConnection functions,
with the Connection type.

Defining the database associated with a connection Hide the details

<Connection>.Database = <New associated database>

<Connection>: Name or variable of type Connection

Name of the connection used. This name is defined:
in the data model editor,
with the HDescribeConnection and HOpenConnection functions,
with the Connection type.

<New associated database>: Character string

Database used as data source for the connection.
Empty string ("") if no specific database is associated with the connection.

Remarks

The CtInitialCatalog property gets the default database of a connection. This property is kept for backward compatibility. It is recommended to use the Database property.