Database (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | French

InfoThumbnailGeneration

OperationLogDirectory

Password

PasswordProtected

PersistedCalculatedItem

RepeatableReadSupported

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Database (Property)

In french: BaseDeDonnées

Not available with these kinds of connection

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

Find out 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, if the connection is currently opened, it will be closed and re-opened with the new parameters during the first access to a file that is using this connection.

Remark: The connection can correspond to:

a connection described in the data model editor,
a connection described by HConnect, HDescribeConnection or HOpenConnection.
a connection described by a Connection variable.

Versions 17 and later

This property is now available for iPhone/iPad applications.

New in version 17

This property is now available for iPhone/iPad applications.

Versions 18 and later

This property is now available in Windows Store Apps mode.

New in version 18

This property is now available in Windows Store Apps mode.

Remark: From version 19, HFSQL is the new name of HyperFileSQL.

Versions 21 and later

This property is now available in Universal Windows 10 App mode.

New in version 21

This property is now available in Universal Windows 10 App mode.

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

Finding out 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>: Character string (with or without quotes) or Connection variable

Name of connection used. This name was defined:
in the data model editor,
by HDescribeConnection or HOpenConnection,
by the Connection type.

Defining the database associated with a connection Hide the details

<Connection>..Database = <New associated database>

<Connection>: Character string (with or without quotes) or Connection variable

Name of connection used. This name was defined:
in the data model editor,
by HDescribeConnection or HOpenConnection,
by 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

..CtInitialCatalog is used to find out the default database of a connection. This property is kept for backward compatibility. We recommend that you use the ..Database property.