了解自定义文件

自定义文件中的每个节标题都由包含类型和参数的方括号 ([]) 组成。 四种节类型分别用文本字符串 connect、sql、userlist 或 logs 表示。 参数为文本字符串、默认值、用户指定的标识符或无内容。

重要

从 Windows 8 和 Windows Server 2012 开始，Windows 操作系统不再包含 RDS 服务器组件（有关更多详细信息，请参阅 Windows 8 和 Windows Server 2012 兼容性实用手册）。 Windows 的未来版本中将移除 RDS 客户端组件。 请避免在新的开发工作中使用该功能，并着手修改当前还在使用该功能的应用程序。 使用 RDS 的应用程序应迁移到 WCF 数据服务。

因此，每节都用以下节标题中的一种进行标记：

  
[ connect default ] [ connect    
identifier   
] [ sql  default ] [ sql    
identifier   
] [ userlist    
identifier   
] [ logs ]  
  

节标题包含以下部分。

组成部分	说明
connect	修改连接字符串的文本字符串。
sql	修改命令字符串的文本字符串。
userlist	修改特定用户访问权限的文本字符串。
logs	指定记录操作错误的日志文件的文本字符串。
default	未指定或找到任何标识符时使用的文本字符串。
identifier	与 connect 或 command 字符串中的字符串匹配的字符串。 - 如果节标题包含 connect，且在连接字符串中找到标识符字符串，则使用此节。 - 如果节标题包含 sql，且在命令字符串中找到标识符字符串，则使用此节。 - 如果节标题包含 userlist，且标识符字符串与 connect 节标识符匹配，则使用此节。

DataFactory 调用处理程序，传递客户端参数。 处理程序在客户端参数中搜索与相应节标题中的标识符匹配的整个字符串。 如果找到匹配字符串，此节内容将应用于客户端参数。

在以下情况下使用特定节：

• 如果客户端连接字符串关键字的值部分“Data Source=value”与 connect 节标识符匹配，则使用 connect 节。

• 如果客户端命令字符串包含与 sql 节标识符匹配的字符串，则使用 sql 节。

• 如果没有匹配标识符，则使用具有默认参数的 connect 或 sql 节。

• 如果 userlist 节标识符与 connect 节标识符匹配，则使用 userlist 节。 如果匹配，则将 userlist 节的内容应用于由 connect 节控制的连接。

• 如果连接或命令字符串中的字符串与任何 connect 或 sql 节标题中的标识符都不匹配，并且没有具有默认参数的 connect 或 sql 节标题，则无需修改即可使用客户端字符串。

• 只要 DataFactory 处于运行中，就使用 logs 节。

另请参阅

自定义文件 Connect 部分
自定义文件 Logs 部分
自定义文件 SQL 部分
自定义文件 UserList 部分
自定义 DataFactory
必需的客户端设置
编写自己的自定义处理程序