Определяет параметры настройки для активного подключения. Вы можете использовать SQLSETPROP( ), чтобы определить параметры настройки на уровне подключения. Чтобы определить параметры по умолчанию Visual FoxPro на уровне среды, включите 0 как дескриптор подключения.

SQLSETPROP(nStatementHandle, cSetting [, eExpression])

Параметры

nStatementHandle

Определяет дескриптор подключения к источнику данных, возвращенному SQLCONNECT( ).
cSetting

Определяет установки. Следующая таблица перечисляет значения для cSetting.

Установка Описание

Асинхронный

Определяет, возвращены ли результаты синхронно (Ложь (.F.), значение по умолчанию), или асинхронно (Истина (.T.)). Для чтения/записи.

BatchMode

Определяет, возвращает ли SQLEXEC( ) результаты целиком (Истина (.T)., значение по умолчанию), или индивидуально с использованием SQLMORERESULTS( ) (Ложь (.F.)). Чтение/запись.

ConnectBusy

Содержит Истину (.T). если разделяемое подключение занято; иначе содержит Ложь (.F).. Только для чтения.

ConnectString

Строка подключения для входа в систему. Только для чтения.

ConnectTimeOut

Определяет время ожидания (в секундах) перед возвращением ошибки из-за таймаута. Если Вы определяете 0, период ожидания неопределен, и ошибка из-за таймаута никогда не возвращается. ConnectTimeOut может составлять от 0 до 600. Значение по умолчанию - 15. Чтение/запись.

DataSource

Имя источника данных, как определено в файле ODBC.INI. Чтение/запись.

DisconnectRollback

Определяет завершена ли ожидающая транзакция или произошел откат, когда вызывается SQLDISCONNECT( ) для последнего дескриптора подключения.

Значением по умолчанию является ложь (.F)., указывая, что ожидающая транзакция завершена, когда SQLDISCONNECT( ) вызывается для последнего дескриптора подключения.

Определите истину (.T). для отката ожидающей транзакции, когда SQLDISCONNECT( ) вызывается для последнего дескриптора подключения.

На подключение с автоматическим процессингом транзакций это установка не влияет.

Чтение/запись.

DispLogin

Содержит числовое значение, которое определяет, когда отображается диалоговое окно Login ODBC. DispLogin может принимать следующие значения:

1 или DB_PROMPTCOMPLETE (от FOXPRO.H).1 - значение по умолчанию.

2 или DB_PROMPTALWAYS (от FOXPRO.H).

3 или DB_PROMPTNEVER (от FOXPRO.H).

Если 1 или DB_PROMPTCOMPLETE определен, Visual FoxPro отображается диалоговое окно Login ODBC, только если отсутствует любая требуемая информация.

Если 2 или DB_PROMPTALWAYS определен, диалоговое, окно Login ODBC всегда отображается, позволяя Вам изменить настройку перед соединением.

Если 3 или DB_PROMPTNEVER определен, диалоговое, окно Login ODBC не отображено, и Visual FoxPro генерирует ошибку, если требуемая информация входа в систему не доступна. Чтение/запись.

DispWarnings

Определяет, отображены ли сообщения об ошибках (Истина (.T.)) или не отображены (Ложь (.F)., значение по умолчанию). Чтение/запись.

IdleTimeout

Неактивный интервал блокировки времени в минутах. Активные подключения дезактивированы после начала указанного интервала времени. Значение по умолчанию - 0 (ждать неопределенно). Чтение/запись.

ODBChdbc

Внутренний дескриптор подключения ODBC, который может использоваться внешними библиотечными файлами (FLL файлы), чтобы вызвать ODBC. Только для чтения.

ODBChstmt

Внутренний дескриптор инструкции ODBC, который может использоваться внешними библиотечными файлами (FLL файлы), чтобы вызвать ODBC. Только для чтения.

PacketSize

Размер сетевого пакета, используемого подключением. Корректировка этого значения может улучшить выполнение. Значение по умолчанию - 4096 байтов (4K). Чтение/запись

Password

Пароль подключения. Только для чтения.

QueryTimeOut

Определяет время, чтобы ожидать (в секундах) перед возвращением общей ошибки таймаута. Если Вы определяете 0 (значение по умолчанию), ожидание неопределено, и ошибка из-за блокировки по времени никогда не возвращается. QueryTimeOut может быть от 0 до 600. Чтение/запись.

Shared

Определяет, является ли основное подключение разделяемым подключением (Истина (.T.)), или нет (Ложь (.F.)).

Только для чтения.

Transactions

Содержит числовое значение, которое определяет, как подключение управляет транзакциями над отдаленной таблицей. Транзакции могут принять следующие значения:

1 или DB_TRANSAUTO (от FOXPRO.H).1 - значение по умолчанию. Процессинг транзакций для отдаленной таблицы происходит автоматически.

2 или DB_TRANSMANUAL (от FOXPRO.H). Процессинг транзакций управляется вручную через SQLCOMMIT( ) и SQLROLLBACK( ) . Чтение/запись.

UserId

Пользовательский идентификатор. Только для чтения.

WaitTime

Время в миллисекундах через которое Visual FoxPro проверяет завершилось ли выполнение инструкции SQL. Значение по умолчанию - 100 миллисекунды. Чтение/запись.

eExpression

Определяет значение для установки, которой Вы определяете cSetting . Если Вы опускаете eExpression , значение по умолчанию для установки восстановливается.

Возвращаемое значение

Числовой тип данных. SQLSETPROP( ) возвращается 1, если она успешна. Иначе, она возвращает - 1, если происходит ошибка уровня подключения или - 2, если ошибка уровня среды.

Замечания

Вы можете использовать SQLGETPROP( ), чтобы возвратить текущее значение для указанной установки.

Обратите внимание:
Вы должны отключить диалоговое окно входа в систему ODBC, чтобы обеспечить передачу SQL, Серверу Транзакций Microsoft. Чтобы отключить диалоговое окно входа в систему ODBC, используйте инструкцию SQLSETPROP(cStatementHandle, 'DispLogin ', 3) , где cStatementHandle является дескриптором соединения, возвращенным SQLCONNECT( ) . Вы можете также отключить диалоговое окно входа в систему ODBC в Проектировщике Подключения .

Опция ConnectTimeOut может быть установлена только на уровне Visual FoxPro, и не имеет никакого эквивалента на уровне подключения. Вы можете установить все другие опци или на ауровне подключения или на уровне Visual FoxPro. Каждый набор опции на уровне Visual FoxPro служит значением по умолчанию для последующих подключений.

Пример

Следующий пример показывает, как используется SQLSETPROP( ) чтобы установить размер пакета для текущего подключения. SQLCONNECT( ) отображает диалоговые окна Выбор Подключения или Источник Данных, чтобы выбрать подключение, и проверить подключение. Размер пакета установлен; установка проверена; и результаты отображены.

Скопировать код
CLOSE ALL
CLEAR ALL
CLEAR
nHandle=SQLCONNECT()
IF nHandle > 0
nSet=SQLSETPROP(nHandle, "PacketSize", 2048 )
IF nSet > 0
=MESSAGEBOX("PacketSize was set to 2048",0,"Connection Results")
ELSE
=MESSAGEBOX("Error setting PacketSize",0,"Connection Results")
ENDIF
ELSE
=MESSAGEBOX("No Connection",0,"Connection Results")
ENDIF
=SQLDISCONNECT(nHandle)

См. Также