ListFoldersOptions
ListFoldersOptions enumeration
文件夹列表选择选项 请注意,如果服务器支持 RFC 5258 “IMAP LIST 命令扩展”,则支持此选项 请参阅 https://tools.ietf.org/html/rfc5258 中的更多详细信息
[Flags]
public enum ListFoldersOptions
价值观
姓名 | 价值 | 描述 |
---|---|---|
None | 0 | 未定义 |
Subscribed | 1 | SUBSCRIBED - 使 LIST 命令列出订阅的名称, 而不是现有的邮箱。 这通常是实际邮箱的子集。 此列表也可能包含不存在的邮箱的名称。 在任何情况下,列表必须准确包含那些与规范列表模式匹配并被订阅的邮箱名称。 此选项旨在补充 LSUB 命令。 特别值得注意的是此选项返回的邮箱属性,与 LSUB 返回的相比。 使用后者,返回的属性可能无法反映邮箱名称的实际属性状态, 和 \NoSelect 属性还有第二个特殊含义(它表示此邮箱本身不是订阅的,但它有后代邮箱那是)。 使用这里描述的 SUBSCRIBED 选择选项,属性准确完整,没有特殊含义。 “LSUB”和“LIST (SUBSCRIBED)”因此不是一回事,一些服务器必须做大量额外的工作来响应“LIST (SUBSCRIBED)”。 因此,客户端应该继续使用“LSUB”,除非他们特别想要“LIST (SUBSCRIBED)”提供的附加信息。 这个选项定义了一个新的邮箱属性,“\Subscribed”,它表示邮箱名称是订阅。 必须支持“\Subscribed”属性,并且必须在指定 SUBSCRIBED 选择选项时准确计算。 请注意,SUBSCRIBED 选择选项意味着 SUBSCRIBED 返回选项(见下文)。 |
Remote | 2 | REMOTE - 使 LIST 命令显示远程邮箱以及本地邮箱,如 [MBRef] 中所述。 此选项旨在替换 RLIST 命令,并与 SUBSCRIBED 选择选项一起替换 RLSUB 命令。 此选项定义了一个新邮箱属性“\Remote”,它指示邮箱是远程邮箱。 “\Remote”属性必须在指定 REMOTE 选项时准确计算。 REMOTE 选择选项与其他选项没有交互。 它的作用是告诉服务器将其他选项(如果有)应用于远程邮箱,在除了本地的。 特别是,它与 RECURSIVEMATCH 没有交互(见下文)。 (REMOTE RECURSIVEMATCH) 请求无效,因为 (RECURSIVEMATCH) 请求无效。 (REMOTE RECURSIVEMATCH SUBSCRIBED) 请求请求所有订阅的邮箱,包括本地和远程。 |
RecursiveMatch | 4 | RECURSIVEMATCH - 此选项强制服务器返回有关与其他选择选项不匹配但有一些子邮箱匹配的父邮箱的信息。 在 CHILDINFO 扩展数据项中返回有关子项的信息。 注 1:为了返回父邮箱,它仍然必须匹配规范 LIST 模式。 注 2:返回 CHILDINFO 扩展数据项时,子邮箱是否匹配规范 LIST 无关紧要图案。 RECURSIVEMATCH 选项不得作为唯一的选择选项出现(或仅与 REMOTE 一起出现),因为它仅在同时使用其他选择选项时才有意义。 在这种情况下,服务器必须返回带有 BAD 标记的响应。 请注意,即使指定了 RECURSIVEMATCH 选项, 客户端仍然必须能够处理返回 CHILDINFO 扩展数据项并且没有子邮箱 满足后续 LIST 命令 的选择标准的情况,因为它们可以在发送 LIST 响应后删除/重命名,但在客户端有机会访问它们之前。 |