Свойство LocalConnectionString (удаленный доступ к данным)
Свойство LocalConnectionString служит для задания строки подключения OLE DB для базы данных SQL Server Compact 3.5 на устройстве под управлением Microsoft Windows CE.
Синтаксис
object.LocalConnectionString(value)
Область применения
Объект удаленного доступа к данным SQL Server Compact 3.5
Тип данных
String
Возможность изменения
Чтение и запись
Прототип
HRESULT get_LocalConnectionString(BSTR *pVal);
HRESULT put_LocalConnectionString(BSTR newVal);
Параметры
Параметр |
Описание |
|---|---|
value |
Строка подключения OLE DB для базы данных SQL Server Compact 3.5. |
Замечания
В следующей таблице приведены имена доступных свойств строки соединения OLE DB.
Свойство |
Описание |
|---|---|
data source |
Путь к файлу и имя базы данных SQL Server Compact 3.5. Необходимо указывать абсолютный, а не относительный путь к файлу базы данных. .gif "Примечание") Примечание
Приложение, которое работает на настольном компьютере, не сможет открыть соединение с базой данных, находящейся в SDF-файле на устройстве. Аналогичным образом приложение, которое работает на устройстве, не сможет открыть соединение с базой данных в SDF-файле, находящемся на настольном компьютере.
|
ssce: database password |
Пароль базы данных, имеющий длину до 40 знаков. Если значение не указано, то по умолчанию задается работа без пароля. Это свойство является обязательным, если включено шифрование базы данных. Если пароль задан, то включается шифрование базы данных. Если в качестве пароля задана пустая строка, база данных не будет зашифрована. |
ssce: encrypt database |
Значение типа Boolean, определяющее, выполняется ли шифрование базы данных. Значение true включает шифрование, значение false — отключает. Если значение не указано, по умолчанию используется значение false. Если шифрование включено, то необходимо в соответствующем свойстве задать пароль. Если задать пароль, то шифрование будет включено, независимо от значения, указанного для этого свойства. Если задан пароль, то база данных будет шифроваться независимо от того, задано ли значение SSCE:Encrypt Database. Примечание
В следующей версии свойство encrypt будет устаревшим. Оно сохранено в SQL Server Compact 3.5 в целях обратной совместимости.
|
ssce:encryption mode или encryption mode |
Это свойство может принимать значения engine default, platform default, ppc2003 compatibility. Значение по умолчанию: platform default. |
ssce: max buffer size |
Максимальный объем памяти в килобайтах, после превышения которого SQL Server Compact 3.5 начнет записывать изменения на диск. Если не указано, значением по умолчанию является 640. |
ssce: max database size |
Максимальный размер базы данных в мегабайтах. Если значение не указано, значением по умолчанию является 128. |
ssce:mode |
Режим, используемый при открытии файла базы данных. Допустимые значения перечислены в следующей таблице. Если значение не указано, значением по умолчанию является Read/Write. |
ssce: default lock timeout |
Предусмотренное по умолчанию время ожидания транзакцией блокировки в миллисекундах. Если значение не указано, значением по умолчанию является 2 000. |
ssce: default lock escalation |
Число блокировок в транзакции, после которого будет предпринята попытка укрупнения с уровня строки до уровня страницы или с уровня страницы до уровня таблицы. Если значение не указано, значением по умолчанию является 100. |
ssce: flush interval |
Промежуток времени в секундах, по истечении которого все зафиксированные транзакции записываются на диск. Если значение не указано, значением по умолчанию является 10. |
ssce: autoshrink threshold |
Процентная доля свободного места в файле базы данных, по достижении которой начинается автосжатие. Если задано значение 100, автосжатие отключается. Если значение не указано, значением по умолчанию является 60. |
ssce: temp file directory |
Расположение временной базы данных. Если значение не указано, то по умолчанию используется база данных, указанная в свойстве источника данных для временного хранения |
ssce: temp file max size |
Максимальный размер файла временной базы данных в мегабайтах. Если значение не указано, значением по умолчанию является 128. |
locale identifier |
Код языка, который следует использовать в этой базе данных. |
ssce:case sensitive |
Логическое значение, определяющее, учитывает ли база данных регистр. При значении true учет регистра включен, при значении false — отключен. Если значение не указано, по умолчанию используется значение false. Примечание
Это свойство соединения было введено в версии SQL Server Compact 3.5.
|
В следующей таблице показаны допустимые значения для свойства mode строки соединения.
Значение |
Определение |
|---|---|
Read Write |
Разрешает нескольким процессам открывать и изменять базу данных. Это значение по умолчанию, если свойство режима не задано. |
Read Only |
Позволяет открыть копию базы данных, доступную только для чтения. |
Exclusive |
Запрещает другим процессам открывать или изменять базу данных. |
Shared Read |
Разрешает другим процессам читать, но не изменять базу данных, пока она открыта. |
К строкам соединений применимы следующие правила.
Все пустые символы, за исключением помещенных внутри значений или кавычек, не учитываются.
Пары «ключевое слово-значение» должны разделяться точкой с запятой (;). Если точка с запятой является частью значения, то границы значения необходимо обозначить кавычками.
Escape-последовательности не поддерживаются.
Тип значения неважен.
Имена не учитывают регистр.
Если имя свойства повторяется в строке соединения несколько раз, то используется значение, заданное последним найденным вхождением.
Значения могут быть заключены в одинарные или двойные кавычки, например: name='value' или name="value". И одинарные, и двойные кавычки могут использоваться в строке соединения; при этом функцию разделителя должны выполнять кавычки другого типа. Ниже приводятся примеры допустимого применения кавычек в строке соединения.
"data source='MyDb.sdf'; ssce: mode=Exclusive;" 'data source="MyDb.sdf"; ssce: mode=Exclusive;'- Следующие примеры являются недопустимыми.
"data source="MyDb.sdf"; ssce: mode=Exclusive;" 'data source='MyDb.sdf'; ssce: mode=Exclusive;'