Свойство SqlCeConnection.ConnectionString
Возвращает или задает строку, используемую для открытия базы данных.
Пространство имен: System.Data.SqlServerCe
Сборка: System.Data.SqlServerCe (в System.Data.SqlServerCe.dll)
Синтаксис
'Декларация
Public Overrides Property ConnectionString As String
Get
Set
'Применение
Dim instance As SqlCeConnection
Dim value As String
value = instance.ConnectionString
instance.ConnectionString = value
public override string ConnectionString { get; set; }
public:
virtual property String^ ConnectionString {
String^ get () override;
void set (String^ value) override;
}
abstract ConnectionString : string with get, set
override ConnectionString : string with get, set
override function get ConnectionString () : String
override function set ConnectionString (value : String)
Значение свойства
Тип: System.String
Строка подключения поставщика данных .NET Compact Framework для SQL Server Compact, которая включает имя источника данных и другие параметры, необходимые для установления начального соединения. Значение по умолчанию равно пустой строке.
Реализует
IDbConnection.ConnectionString
Исключения
| Исключение | Условие |
|---|---|
| ArgumentException | Передан недопустимый аргумент строки подключения. |
Замечания
Присваивать значение свойству ConnectionString можно только тогда, когда соединение закрыто. Многие из значений строки подключения имеют соответствующие свойства, доступные только для чтения. Все они обновляются при присваивании строки подключения (если она не содержит ошибок). В последнем случае не будет обновлено ни одно из свойств. Свойства SqlCeConnection возвращают только те параметры, которые содержатся в ConnectionString.
Сброс ConnectionString для закрытого соединения приводит к сбросу всех значений строки подключения и соответствующих свойств, включая пароль.
В следующей таблице перечислены свойства ConnectionString, поддерживаемые в SQL Server Compact.
Свойство |
Описание |
|---|---|
data source или datasource |
Путь к файлу и имя файла базы данных SQL Server Compact. Чтобы указать относительный путь к базе данных из каталога приложения, используйте строку подстановки Data Source = |DataDirectory| (заключенную в символы вертикальной черты). Используйте метод SetData() для объекта AppDomain, чтобы задать каталог данных приложения. Параметр DataDirectory не поддерживается для устройств. Дополнительные сведения см. в разделе Установка и развертывание на настольном компьютере (SQL Server Compact). |
Password или Pwd или database password или ssce:database password |
Пароль базы данных, который может иметь длину до 40 символов. Если значение не указано, то по умолчанию задается работа без пароля. Если в базе данных включено шифрование, то этот параметр является обязательным. При указании пароля шифрование базы данных включается автоматически. Если задан пустой пароль, база данных не будет шифроваться. |
ssce:enlist или enlist |
По умолчанию значением параметра enlist является false. Если его установить в значение true, то соединение с базой данных SQL Server Compact распространяется на транзакцию. |
ssce:encryption mode или encryption mode |
Это свойство может принимать значения engine default или platform default Значения этого свойства заданы по умолчанию для платформы. .gif "Примечание") Примечание
Это свойство является параметром времени создания базы данных и не учитывается при соединении с существующей базой данных.
|
Encrypt, encrypt database или ssce: encrypt database |
Логическое значение, которое определяет, применяется ли шифрование в базе данных. Необходимо задать значение true, чтобы включить шифрование, или значение false, чтобы отключить шифрование. Если значение не указано, по умолчанию используется значение false. Если шифрование включено, то необходимо также задать пароль с помощью свойства password. При задании пароля шифрование будет включено независимо от значения этого свойства. Примечание
Это свойство является параметром времени создания базы данных и не учитывается при соединении с существующей базой данных. Если задано свойство SSCE:Database password, то база данных будет шифроваться независимо от значения SSCE:Encrypt Database.
|
max buffer size или ssce:max buffer size |
Наибольший объем памяти (в килобайтах), который может быть выделен SQL Server Compact, прежде чем начнется запись изменений на диск. Если не указано, значение по умолчанию равно 640. |
max database size или ssce:max database size |
Максимальный размер базы данных (в мегабайтах). Если не указано, значение по умолчанию равно 128. |
Mode или file mode или ssce:mode |
Режим, применяемый при открытии файла базы данных. Список допустимых значений см. в следующей таблице. Если не указано иное, то значением по умолчанию является «Read Write». |
default lock timeout или ssce: default lock timeout |
Время по умолчанию (в миллисекундах), в течение которого в транзакции происходит ожидание освобождения блокировки. Если не указано, значение по умолчанию равно 2000. |
default lock escalation или ssce:default lock escalation |
Число блокировок, которые должна получить транзакция, прежде чем будет осуществлена попытка их укрупнения от строки до страницы или от страницы до таблицы. Если не указано, значение по умолчанию равно 100. |
flush interval или ssce:flush interval |
Указывает продолжительность интервала (в секундах), по истечении которого все зафиксированные транзакции записываются на диск. Если не указано, значение по умолчанию равно 10. |
autoshrink threshold или ssce:autoshrink threshold |
Процентная доля свободного места в файле базы данных, наличие которого допускается до начала автосжатия. При значении 100 автосжатие отключается. Если не указано, значение по умолчанию равно 60. |
temp path или temp file directory или ssce:temp file directory |
Местоположение временной базы данных. Если это значение не задано, то по умолчанию используется база данных, указанная в свойстве источника данных для временного хранения. |
temp file max size |
Максимальный размер временного файла базы данных (в мегабайтах). Если не указано, значение по умолчанию равно 128. |
persist security info |
Если это значение равно false (настоятельно рекомендуется), то конфиденциальные сведения (например, пароль) из соединения будут недоступны, если соединение открыто или когда-либо находилось в открытом состоянии. При сбросе строки подключения будут сброшены все ее значения, включая пароль. Значение по умолчанию — false. |
locale identifier или Lcid или initial lcid |
Код локали (LCID), используемый базой данных. Допустимые значения кода локали определяет перечислитель CultureInfo. Примечание
Это свойство является параметром времени создания базы данных и не учитывается при соединении с существующей базой данных.
|
Case Sensitive или CaseSensitive |
Логическое значение, определяющее, учитывается ли регистр в параметрах сортировки базы данных. Чтобы включить параметры сортировки с учетом регистра, необходимо установить значение true, а для параметров сортировки без учета регистра — значение false. Если значение не указано, по умолчанию используется значение false. Во время соединения с существующей базой данных SQL Server Compact со свойством «Case Sensitive» в строке подключения SQL Server Compact 3.5 с пакетом обновления 1 (SP1) не учитывает его значение. Примечание
Это свойство является параметром времени создания базы данных и не учитывается при соединении с существующей базой данных.
|
В следующей таблице приведены допустимые значения для свойства mode строки подключения.
Значение |
Определение |
|---|---|
Read Write |
Позволяет нескольким процессам открывать и изменять базу данных. Это значение по умолчанию действует, если значение свойства mode не задано. |
Read Only |
Позволяет пользователю открывать копию базы данных, доступную только для чтения. |
Exclusive |
Исключает возможность открытия и изменения базы данных другими процессами. |
Shared Read |
Допускает возможность чтения, но не изменения базы данных другими процессами, пока она открыта. |
Если задано это свойство, выполняется предварительная проверка строки подключения. Если в приложении вызывается метод Open, производится полная проверка строки подключения. Если строка подключения содержит неподдерживаемые или недопустимые свойства, то во время выполнения возникает исключение ArgumentException.
К строке подключения применяются следующие правила.
Пропускаются все символы пробелов, кроме входящих в состав значения или заключенных в кавычки.
Пары «ключевое слово-значение» должны разделяться точками с запятой (;). Если точка с запятой является частью значения, то границы значения необходимо обозначить кавычками.
Escape-последовательности не поддерживаются.
Тип значения неважен.
В именах не учитывается регистр символов.
Если имя свойства встречается в строке подключения несколько раз, то используется значение, заданное для последнего вхождения.
Значения могут быть заключены в одинарные или двойные кавычки (например «name='value'» или «name="value"»). В строке подключения при использовании другого разделителя могут применяться либо одинарные, либо двойные кавычки. Например, допустимым является следующий вариант использования кавычек в строке подключения.
"data source='MyDb.sdf'; mode=Exclusive;" 'data source="MyDb.sdf"; mode=Exclusive;'А следующие примеры являются недопустимыми.
"data source="MyDb.sdf"; mode=Exclusive;" 'data source='MyDb.sdf'; mode=Exclusive;'
Примеры
В следующем примере создается соединение SqlCeConnection и в строке подключения задаются некоторые его свойства.
Dim conn As New SqlCeConnection()
' Set some connection string properties e.g.:
'
conn.ConnectionString = _
"Persist Security Info = False; Data Source = 'SalesData.sdf';" & _
"Password = '<password>'; File Mode = 'shared read'; " & _
"Max Database Size = 256; Max Buffer Size = 1024"
conn.Open()
' You can change the database while preserving
' the orignal connection options
'
conn.ChangeDatabase("SupportData.sdf")
SqlCeConnection conn = new SqlCeConnection();
// Set some connection string properties e.g.:
//
conn.ConnectionString =
"Persist Security Info = False; Data Source = 'SalesData.sdf';" +
"Password = '<password>'; File Mode = 'shared read'; " +
"Max Database Size = 256; Max Buffer Size = 1024";
conn.Open();
// You can change the database while preserving
// the orignal connection options
//
conn.ChangeDatabase("SupportData.sdf");
См. также
Справочник
Пространство имен System.Data.SqlServerCe