• SQL Events
• *like Function
• *sql_where Function
• a5_ADO_ResolveConnectionString Function
• a5_alphadao_export Function
• a5_alphadao_import Function
• a5_alphadao_search Function
• a5_alphadaoexportgenie Function
• a5_alphadaoimportgenie Function
• a5_arguments_sqllist Function
• A5_BatchPassiveLinkCreate Function
• a5_changealias_insql Function
• a5_complete_import_task Function
• a5_connectionpropstostring Function
• A5_CONNECTIONSTRING Function
• a5_connstrings_list Function
• a5_convert_delete_to_sql_delete Function
• a5_convert_deletedups_to_sql Function
• a5_convert_update_to_sql_update Function
• A5_CreateLayoutFromDataSource Function
• A5_CreatePassiveLinkTable Function
• a5_createsql_layout Function
• a5_createtable_sql_import Function
• a5_csweb_syntaxnamefromado Function
• a5_databaseexplorer Function
• a5_defineconnectionstring Function
• A5_ExcelConnString Function
• a5_exportconnectionstrings Function
• a5_getalphasqlfunction Function
• a5_getnamedconnectionstring Function
• a5_getnamedsqldatasource Function
• a5_getprimarykeysfromdaosearchresult Function
• a5_getreportsqlfilter Function
• a5_getreportsqlorder Function
• a5_getsavedadoconn_string Function
• a5_importconnectionstrings Function
• A5_ImportTablesDialog Function
• a5_invertsqlorder Function
• a5_list_tables_with_types Function
• a5_lookupsavedconnectionstring Function
• A5_MDBConString Function
• a5_mergeDataIntoTemplate Function
• a5_mergesqlarguments Function
• a5_namedconnectioncreate Function
• a5_odbc_connection Function
• a5_odbc_import_genie Function
• a5_paradoxconnstring Function
• A5_PassiveLinkTableDefine Function
• a5_preview_datasource Function
• A5_RefreshPassiveLinkTable Function
• A5_RefreshPassiveLinkTableDialog Function
• a5_sql_addcolumnstoselect Function
• a5_sql_addfilterorder Function
• a5_sql_arguments_dump Function
• a5_sql_arguments_load Function
• A5_SQL_BatchImportTables Function
• a5_sql_builder_simple Function
• a5_sql_cache_datafilename Function
• a5_sql_commandwindow Function
• a5_sql_droptables Function
• a5_sql_extractorder Function
• a5_sql_generate_select2 Function
• A5_SQL_ImportDataSource Function
• a5_sql_parsewhereclause Function
• a5_sql_parsewhereclause_datatypes Function
• a5_sql_query_genie Function
• A5_SQL_QuerySaveAs Function
• a5_sql_record_content_get Function
• a5_sql_record_xbase_content_get Function
• a5_sql_removeorder Function
• a5_sql_table_selector Function
• a5_sqlconnectionstring_unhidepassword Function
• a5_sqlexpressionbuilder Function
• a5_sqlimport_execute Function
• A5_SQLResultSetPreview Function
• a5_sqlToJSONExpandingMenu Function
• a5cs_decomposeaggregateexpression Function
• a5cs_generatenativefilter Function
• a5cs_generatenativeorder Function
• a5cs_getfunctionsinsqlexpression Function
• a5cs_getprimarykeycolumns Function
• a5cs_sql_add_filter_order Function
• a5cs_validateexpression Function
• a5gridhelper_dumpargumentstohtml Function
• a5Helper_findRecordInSQLTable Function
• a5SQLConnectionOpen Function
• a5wcb_exportstaticdatatosql Function
• argval Function
• cn_open Function
• combine_sql_arguments Function
• create_table_sql Function
• DataTransformExpression Example
• Portability Functions
• replace_arguments_in_string Function
• replace_placeholders_with_argument_values Function
• showresultset Function
• sql_argumentsdialog Function
• sql_avg Function
• sql_cacheapplyupdates Function
• sql_cacheevents Function
• sql_cachefetchpage Function
• sql_cachefetchpageeventscript Function
• sql_cacheopen Function
• sql_cacherefresh Function
• sql_cacherefreshinsertedrow Function
• sql_cacherefreshrow Function
• sql_childrelationsadded Function
• sql_childrelationsclear Function
• sql_childrelationspopulate Function
• SQL_ConnectionStringDialog Function
• SQL_ConnectString Function
• sql_count Function
• SQL_DatabaseExportDialog Function
• SQL_DATE Function
• sql_delete Function
• Sql_get_Values Function
• sql_import Function
• sql_insert Function
• SQL_InstallOracleLiteFunctions Function
• sql_linkcreate Function
• sql_listoptionsdialog Function
• SQL_Lookup Function
• SQL_lookup_multi Function
• sql_max Function
• sql_min Function
• sql_namedinstanceget Function
• sql_nameinstancegetsimple Function
• sql_primarykeydialog Function
• sql_query Function
• SQL_QUERY_BUILDER Function
• SQL_QueryImport Function
• sql_queryrenamewhereclausearrayoperators2 Function
• sql_quote Function
• SQL_Records_Get Function
• SQL_ResultSet_Preview Function
• sql_safeexecute Function
• sql_sum Function
• SQL_TableExport Function
• SQL_TableExportDialog Function
• SQL_TableImport Function
• SQL_TableImportDialog Function
• SQL_TableInfoOfDBF Function
• sql_tableinfotodbf Function
• SQL_TableInfoToOpenTable Function
• sql_tableinfotostring Function
• sql_time Function
• sql_update Function
• sql_upsert Function
• SYS_REMOVE Function

a5SQLConnectionOpen Function

Syntax

Arguments

Result_Flag

TRUE (.T.) if the operation was successful; otherwise FALSE (.F.)

cn

A SQL::Connection object.

connString

The name of the dynamic connection string to use. The dynamic connection string used must be defined in the session object.

session

The session object.

Description

Opens a connection to a database. This method supports using dynamic connection syntax.

Discussion

The a5SQLConnectionOpen() function can be used to open a connection to a SQL database. If the connection string uses the dynamic connection syntax, it will correctly resolve the correct connection string to use.

Take, for instance, the "standard" way of opening a connection:

dim cs as c 
cs = ":name::myconnstring"
dim cn as sql::connection
dim flag as l 
flag = cn.open(cs)

This can be rewritten using a dynamic connection using the a5SQLConnectionOpen() function as follows:

'using the a5SQLConnectionOpen() function
'assume that some prior code has set this session variable
session.__protected__conn1 = "::name::myOtherConnectionString"

dim cs as c 
cs = "::name::DynamicConnection_conn1"
dim cn as sql::connection
flag = a5SQLConnectionOpen(cn,cs,session)

Since the connection string you are trying to open is a dynamic connection (because the connection string name starts with 'DynamicConnection') the actual connection string that will be opened is the connection string specified by session.__protected__conn1.

This connection string is ::name::myOtherConnectionString. So the connection opened by this function will be ::name::myOtherConnectionString.

See Also

• Building Multi-Tenant Applications - Dynamic Connection Strings
• SQL::Connection::Open Function