DirectoryBrowseSection 类
在 IIS 中配置目录浏览。
语法
class DirectoryBrowseSection : ConfigurationSection
方法
下表列出了 DirectoryBrowseSection 类公开的方法。
| 名称 | 描述 |
|---|---|
| GetAllowDefinition | （继承自 ConfigurationSection。） |
| GetAllowLocation | （从 ConfigurationSection 继承。） |
| RevertToParent | （从 ConfigurationSection 继承。） |
| SetAllowDefinition | （从 ConfigurationSection 继承。） |
| SetAllowLocation | （从 ConfigurationSection 继承。） |
属性
下表列出了 DirectoryBrowseSection 类公开的属性。
| 名称 | 描述 |
|---|---|
Enabled |
一个读/写 boolean 值。 如果将为 IIS 中的目录启用目录浏览，则为 true；否则为 false。 默认为 false。 |
Location |
（继承自 ConfigurationSection。）一个键属性。 |
Path |
（继承自 ConfigurationSection。）一个键属性。 |
SectionInformation |
（从 ConfigurationSection 继承。） |
ShowFlags |
一个 sint32 值，该值包含一个掩码，用于配置浏览目录中文件信息的显示。 后文的“注解”部分列出了可能的值。 |
子类
此类不包含子类。
注解
如果为 IIS 中的目录启用了目录浏览，则用户会收到一个页面，其中列出了目录的内容（如果满足以下条件）：
用户未在 URL 中指定文件（例如，用户转到
http://www.contoso.com/而不是http://www.contoso.com/default.htm).）默认文档在 IIS 中已禁用，或者 IIS 无法在目录中找到与 IIS 默认文档列表中指定的名称匹配的文件。
注意
默认情况下，会在 IIS 中禁用目录浏览，因此用户无法看到目录的内容。 为了增强安全性，应保持目录浏览处于禁用状态，除非有特定原因启用它，例如，使用 Web 分布式创作和版本控制 (WebDAV) 通过 HTTP 共享文件。 如果启用目录浏览，请确保仅在要共享的一个或多个特定目录上启用它。
下表列出了 ShowFlags 属性的可能值。 默认值为 2 (Date)、4 (Time)、8 (Size) 和 16 (Extension)。
| 值 | 关键字 | 说明 |
|---|---|---|
| 0 | None |
显示不具有扩展名的文件名。 如果已指定其他标志，该标志无效。 |
| 2 | Date |
每个文件的上次修改日期。 |
| 4 | Time |
每个文件的上次修改时间。 |
| 8 | Size |
每个文件的大小。 |
| 16 | Extension |
文件名后面的文件扩展名。 |
| 32 | LongDate |
每个文件的上次修改日期采用扩展格式。 |
示例
以下示例显示默认网站的 DirectoryBrowseSection 类的属性。
' Connect to the WMI WebAdministration namespace.
Set oWebAdmin = _
GetObject("winmgmts:root\WebAdministration")
Set oService = GetObject("winmgmts:root\WebAdministration")
' Get the directory browse section of the default Web site.
Set oSite = oService.Get("Site.Name='Default Web Site'")
oSite.GetSection "DirectoryBrowseSection", oSection
' Display the properties.
WScript.Echo "DirectoryBrowseSection Properties"
WScript.Echo "---------------------------------"
WScript.Echo "Path: " & oSection.Path
WScript.Echo "Location: " & oSection.Location
WScript.Echo "Enabled: " & oSection.Enabled
WScript.Echo "ShowFlags: " & oSection.ShowFlags
WScript.Echo
WScript.Echo "DirectoryBrowseSection.SectionInformation"
WScript.Echo "-----------------------------------------"
WScript.Echo "OverrideMode: " & oSection.SectionInformation.OverrideMode
WScript.Echo "EffectiveOverrideMode: " & oSection.SectionInformation.EffectiveOverrideMode
WScript.Echo "IsLocked: " & _
oSection.SectionInformation.IsLocked
WScript.Echo "LockItem: " & _
oSection.SectionInformation.LockItem
继承层次结构
DirectoryBrowseSection
要求
| 类型 | 描述 |
|---|---|
| 客户端 | - IIS 7.0（在 Windows Vista 上） - IIS 7.5（在 Windows 7 上） - IIS 8.0（在 Windows 8 上） - IIS 10.0（在 Windows 10 上） |
| 服务器 | - IIS 7.0（在 Windows Server 2008 上） - IIS 7.5（在 Windows Server 2008 R2 上） - IIS 8.0（在 Windows Server 2012 上） - IIS 8.5（在 Windows Server 2012 R2 上） - IIS 10.0（在 Windows Server 2016 上） |
| 产品 | - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0 |
| MOF 文件 | WebAdministration.mof |