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

SqlCeConnection.ConnectionString Property

  • Статья

Возвращает или задает строку, используемую для открытия базы данных.

Пространство имен: System.Data.SqlServerCe
Сборка: System.Data.SqlServerCe (в system.data.sqlserverce.dll)

Синтаксис

'Декларация
Public Overrides Property ConnectionString As String

public override string ConnectionString { get; set; }

public:
virtual property String^ ConnectionString {
    String^ get () override;
    void set (String^ value) override;
}

/** @property */
public String get_ConnectionString ()

/** @property */
public void set_ConnectionString (String value)

public override function get ConnectionString () : String

public override function set ConnectionString (value : String)

Значение свойства

Строка соединения поставщика данных .NET Compact Framework для SQL Server Compact 3.5, которая включает имя источника данных и другие параметры, необходимые для установления начального соединения. Значение по умолчанию равно пустой строке.

Исключения

Тип исключения Условие
ArgumentException

Передан недопустимый аргумент строки соединения.

Замечания

Присваивать значение свойству ConnectionString можно только тогда, когда соединение закрыто. Многие из значений строки соединения имеют соответствующие свойства, доступные только для чтения. Все они обновляются при присваивании строки соединения (если она не содержит ошибок). В последнем случае не будет обновлено ни одно из свойств. Свойства SqlCeConnection возвращают только те параметры, которые содержатся в ConnectionString.

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

В следующей таблице перечислены свойства ConnectionString, поддерживаемые в SQL Server Compact 3.5.

Свойство

Описание

data source или datasource

Путь к файлу и имя базы данных SQL Server Compact 3.5. Чтобы указать относительный путь к базе данных из каталога приложения, используйте строку подстановки Data Source = |каталог_данных| (заключенную в символы вертикальной черты). Используйте метод SetData для объекта AppDomain, чтобы задать каталог данных приложения. Параметр DataDirectory не поддерживается для устройств. Дополнительные сведения см. в разделе Установка и развертывание на настольном компьютере (SQL Server Compact).

Password или Pwd или database password или ssce:database password

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

ssce:enlist

или

enlist

По умолчанию значением параметра enlist является false. Если его установить в значение true, то соединение с базой данных SQL Server Compact 3.5 распространяется на транзакцию.

ssce:encryption mode

или

encryption mode

Это свойство может принимать значения

engine default

или

platform default

или

ppc2003 compatibility

Значения этого свойства заданы по умолчанию для платформы

ew0d66d7.note(ru-ru,VS.90).gifПримечание.
Это свойство является параметром времени создания базы данных и не учитывается при соединении с существующей базой данных.

Encrypt или encrypt database или ssce: encrypt database

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

ew0d66d7.note(ru-ru,VS.90).gifПримечание.
Это свойство является параметром времени создания базы данных и не учитывается при соединении с существующей базой данных. Если задано свойство SSCE:Database password, то база данных будет шифроваться независимо от значения SSCE:Encrypt Database.

max buffer size или ssce:max buffer size

Наибольший объем памяти (в килобайтах), который может быть выделен SQL Server Compact 3.5, прежде чем начнется запись изменений на диск. Если не указано, значение по умолчанию равно 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), используемый базой данных. Допустимые значения LCID определяет перечислитель CultureInfo.

ew0d66d7.note(ru-ru,VS.90).gifПримечание.
Это свойство является параметром времени создания базы данных и не учитывается при соединении с существующей базой данных.

Case Sensitive или CaseSensitive

Логическое значение, определяющее, учитывается ли регистр в параметрах сортировки базы данных. Чтобы включить параметры сортировки с учетом регистра, необходимо установить значение true, а для параметров сортировки без учета регистра — значение false. Если значение не указано, по умолчанию используется значение false. Во время соединения с существующей базой данных SQL Server Compact со свойством «Case Sensitive» в строке соединения SQL Server Compact 3.5 с пакетом обновления 1 (SP1) не учитывает его значение.

ew0d66d7.note(ru-ru,VS.90).gifПримечание.
Это свойство является параметром времени создания базы данных и не учитывается при соединении с существующей базой данных.

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

Значение

Определение

Read Write

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

Read Only

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

Exclusive

Исключает возможность открытия и изменения базы данных другими процессами.

Shared Read

Допускает возможность чтения, но не изменения базы данных другими процессами, пока она открыта.

Если задано это свойство, выполняется предварительная проверка строки соединения. Если в приложении вызывается метод Open, производится полная проверка строки соединения. Если строка соединения содержит неподдерживаемые или недопустимые свойства, то во время выполнения возникает исключение ArgumentException.

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

  1. Пропускаются все символы пробелов, кроме входящих в состав значения или заключенных в кавычки.

  2. Пары «ключевое слово-значение» должны разделяться точками с запятой (;). Если точка с запятой входит в состав значения, то она также должна быть заключена в кавычки.

  3. Управляющие последовательности не поддерживаются.

  4. Тип значения является несущественным.

  5. В именах не учитывается регистр символов.

  6. Если имя свойства встречается в строке соединения несколько раз, то используется значение, заданное для последнего вхождения.

  7. Значения могут быть заключены в одинарные или двойные кавычки (например «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");

Многопоточное использование

Все общие статические члены (Shared в Microsoft Visual Basic) этого типа можно использовать в многопоточных операциях. Безопасная многопоточная работа с членами экземпляров типа не гарантируется.

Платформы

Платформы разработки

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Сведения о версии
.NET Framework и NET Compact Framework
Поддерживается в версии 3.5
.NET Framework
Поддерживается в версии 3.0
.NET Compact Framework и .Net Framework
Поддерживается в версии 2.0

См. также

Справочник

SqlCeConnection Class
SqlCeConnection Members
System.Data.SqlServerCe Namespace

Другие ресурсы

Обновление с предыдущих версий (SQL Server Compact)