Свойство LocalConnectionString (SQL Server Compact Edition)

Статья
05/21/2007

Свойство служит для задания строки соединения для локальной базы данных Microsoft SQL Server 2005 Compact Edition (SQL Server Compact Edition).

Синтаксис

object.LocalConnectionString

Свойства

Часть	Описание
Object	Объект Engine SQL Server Compact Edition

Возможность изменения

Только чтение

Замечания

Настройка свойства LocalConnectionString выполняется только при отсутствии соединения. Многим значениям строки соединения соответствуют свойства, предназначенные только для чтения. Когда строка соединения задана, все эти свойства обновляются, если не выявлена ошибка. При наличии ошибки свойства не обновляются.

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

В таблице перечислены свойства LocalConnectionString, поддерживаемые в SQL Server Compact Edition.

Свойство

Описание

data source

Имя файла базы данных SQL Server Compact Edition и путь к нему.

Примечание.
Необходимо указывать абсолютный, а не относительный путь к файлу базы данных.

ssce: database password

Пароль базы данных длиной до 40 знаков. Если значение не указано, то действительно значение по умолчанию — без пароля. Это свойство является обязательным, если включено шифрование базы данных. Если пароль задан, то включается шифрование базы данных

ssce: encrypt database

Логическое значение, определяющее, выполняется ли шифрование базы данных. При значении "true" шифрование включено, при значении "false" — отключено. Если значение не указано, то действительно значение по умолчанию — false. Если шифрование включено, то необходимо также задать пароль с помощью свойства пароля. Если задать пароль, то шифрование будет включено независимо от значения, указанного для этого свойства

ssce: max buffer size

Максимальный объем памяти в килобайтах, после превышения которого SQL Server Compact Edition начнет сбрасывать изменения на диск. Если значение не указано, то действительно значение по умолчанию — 640

ssce: max database size

Максимальный размер базы данных в мегабайтах. Если значение не указано, то действительно значение по умолчанию — 128

ssce:mode

Режим, используемый при открытии файла базы данных. Допустимые значения перечислены в следующей таблице. Если значение не указано, то действительно значение по умолчанию — Read/Write

ssce: default lock timeout

Предусмотренное по умолчанию время ожидания транзакцией блокировки в миллисекундах. Если значение не указано, то действительно значение по умолчанию — 2000

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

Идентификатор языка и стандартов (LCID), которые следует использовать в этой базе данных

В таблице приведены допустимые значения для свойства режима строки соединения.

Значение	Определение
Read Write	Разрешает нескольким процессам открывать и изменять базу данных. Это значение по умолчанию действует, если значение свойства режима не задано
Read Only	Позволяет открыть копию базы данных, доступную только для чтения
Exclusive	Запрещает другим процессам открывать или изменять базу данных
Shared Read	Разрешает другим процессам читать, но не изменять базу данных, пока она открыта

К строкам соединений приложимы следующие правила.

Все пробелы, за исключением пробелов внутри значений или кавычек, игнорируются.
Пары значений — ключевых слов должны разделяться точкой с запятой (;). Если точка с запятой является частью значения, то границы значения необходимо обозначить кавычками.
Управляющие последовательности не поддерживаются.
Тип значения не является существенным.
Заглавные и строчные буквы в именах не различаются.
Если имя свойства повторяется в строке соединения, то используется значение, связанное с последним вхождением.
Значения могут быть заключены в одинарные или двойные кавычки, например name='value' или name="value". И одинарные, и двойные кавычки могут использоваться в строке соединения; при этом функцию разделителя должны выполнять кавычки другого типа. Ниже приводятся примеры допустимого применения кавычек в строке соединения.
```
"data source='MyDb.sdf'; ssce: mode=Exclusive;"
'data source="MyDb.sdf"; ssce: mode=Exclusive;'
But these examples are not valid:
"data source="MyDb.sdf"; ssce: mode=Exclusive;"
'data source='MyDb.sdf'; ssce: mode=Exclusive;'
```

См. также

Справочник

Объект SSCEError
Метод CompactDatabase (SQL Server Compact Edition)
Коллекция SSCEErrors

Справка и поддержка

Получение помощи по SQL Server Compact Edition

Поделиться через