Общие сведения о файле настроек
Заголовок каждого раздела в файле настройки состоит из квадратных скобок ([]), содержащих тип и параметр. Типы четырех разделов указываются литеральными строками connect, sql, userlist или logs. Параметр — это строка литерала, значение по умолчанию, заданный пользователем идентификатор или ничего.
Важно!
Начиная с Windows 8 и Windows Server 2012 компоненты сервера RDS больше не включаются в операционную систему Windows (дополнительные сведения см. в Windows 8 и Windows Server 2012 совместимости). Клиентские компоненты RDS будут удалены в следующей версии Windows. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется. Приложения, использующие RDS, должны перейти на службу данных WCF.
Таким образом, каждый раздел помечается одним из следующих заголовков раздела:
[ connect default ] [ connect
identifier
] [ sql default ] [ sql
identifier
] [ userlist
identifier
] [ logs ]
Заголовки разделов содержат следующие части.
| Часть | Описание |
|---|---|
| connect; | Строка-литерал, изменяющая строку подключения. |
| sql | Строковый литерал, изменяющий командную строку. |
| список пользователей | Литерал, изменяющий права доступа определенного пользователя. |
| журналы | Литерал строки, указывающий файл журнала, записывающий операционные ошибки. |
| default | Строка литерала, используемая, если идентификатор не указан или не найден. |
| identifier | Строка, соответствующая строке в строке подключения или командной строки. — Используйте этот раздел, если заголовок раздела содержит connect , а строка идентификатора найдена в строке подключения. — Используйте этот раздел, если заголовок раздела содержит sql , а строка идентификатора найдена в командной строке. — Используйте этот раздел, если заголовок раздела содержит список пользователей , а строка идентификатора соответствует идентификатору раздела connect . |
DataFactory вызывает обработчик, передавая параметры клиента. Обработчик ищет целые строки в параметрах клиента, которые соответствуют идентификаторам в соответствующих заголовках разделов. Если совпадение найдено, содержимое этого раздела применяется к параметру клиента.
Конкретный раздел используется в следующих случаях:
Раздел connect используется, если часть значения строки подключения клиента ключевое слово "Data Source=value" соответствует идентификатору раздела подключения.
Раздел SQL используется, если строка команды клиента содержит строку, соответствующую идентификатору раздела SQL .
Если соответствующий идентификатор отсутствует, используется раздел connect или sql с параметром по умолчанию.
Раздел списка пользователей используется, если идентификатор раздела списка пользователей совпадает с идентификатором раздела подключения . При совпадении содержимое раздела списка пользователей применяется к подключению, управляемому разделом connect .
Если строка в соединении или командной строке не соответствует идентификатору в заголовке раздела connect или sql и отсутствует заголовок раздела connect или sql с параметром по умолчанию, то строка клиента используется без изменений.
Раздел logs используется при работе DataFactory .
См. также:
Настройка раздела подключения файла
Настройка раздела журналов файла
Настройка раздела SQL файла
Настройка раздела UserList файла
Настройка DataFactory
Требуемые параметры клиента
Создание собственного настраиваемого обработчика