了解自定义文件

  • 项目

适用于：Access 2013、Office 2013

自定义文件中的每个节标头由包含类型和参数的方括号 ([]) 构成。 节分为四种类型，分别用字面字符串 connect、sql、userlist 或 logs 表示。 参数可以是字面字符串、默认值、用户指定的标识符或为空。

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

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

节标头包含以下部分。

Part

说明

连接

修改连接字符串的字面字符串。

Sql

修改命令字符串的字面字符串。

userlist

修改特定用户访问权限的字面字符串。

日志

指定记录操作错误的日志文件的字面字符串。

default

当未指定或未找到标识符时所使用的字面字符串。

标识符

与 connect 字符串或 command 字符串中的字符串匹配的字符串。

  • 如果节标头中包含 connect 且在连接字符串中找到标识符字符串，则使用此节。

  • 如果节标头中包含 sql 且在命令字符串中找到标识符字符串，则使用此节。

  • 如果节标头中包含 userlist 且标识符字符串与 connect 节标识符匹配，则使用此节。

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

以上各节用在以下不同情况中：

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

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

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

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

  • 如果连接字符串或命令字符串中的字符串与任何 connect 或 sql 节标头中的标识符都不匹配，且不存在带默认参数的 connect 或 sql 节标头，则按原样使用客户端字符串，不进行修改。

  • 只要 DataFactory 处于操作状态，便使用 logs 节。