虚拟目录 <virtualDirectory>

项目
03/25/2024

概述

<virtualDirectory> 元素是 <application> 元素的子元素，控制特定虚拟目录的配置设置。虚拟目录是在 Internet Information Services (IIS) 7 中指定的目录名称（也称为路径），可映射到本地或远程服务器上的物理目录。虚拟目录名称将成为应用程序的 URL 的一部分，用户可以从浏览器请求 URL 以访问物理目录中的内容，例如网页或其他目录和文件列表。如果为虚拟目录指定的名称与物理目录不同，则用户会更难发现服务器上的实际物理文件结构，因为 URL 不会直接映射到站点的根目录。

在 IIS 7 中，每个应用程序都必须有一个虚拟目录（称为根虚拟目录），并将应用程序映射到包含应用程序内容的物理目录。但是，一个应用程序可以有多个虚拟目录。例如，如果希望应用程序包含文件系统中其他位置的映像，但不希望将映像文件移动到映射到应用程序的根虚拟目录的物理目录中，则可以使用虚拟目录。

兼容性

版本	说明
IIS 10.0	`<virtualDirectory>` 元素在 IIS 10.0 中未进行修改。
IIS 8.5	`<virtualDirectory>` 元素在 IIS 8.5 中未进行修改。
IIS 8.0	`<virtualDirectory>` 元素在 IIS 8.0 中未进行修改。
IIS 7.5	`<virtualDirectory>` 元素在 IIS 7.5 中未进行修改。
IIS 7.0	`<virtualDirectory>` 元素是在 IIS 7.0 中引入的。
IIS 6.0	`<virtualDirectory>` 元素替换了 IIS 6.0 IIsWebVirtualDir 和 IIsWebDirectory 元数据库对象。

安装

<virtualDirectory> 元素包含在 IIS 7 的默认安装中。

操作方式

如何创建新的虚拟目录

打开“Internet Information Services (IIS)管理器”：
- 如果使用的是 Windows Server 2012 或 Windows Server 2012 R2：
  - 在任务栏上，单击“服务器管理器”，单击“工具”，然后单击“Internet Information Services (IIS)管理器”。
- 如果使用的是 Windows 8 或 Windows 8.1：
  - 按住 Windows 徽标键，按字母 X，然后单击“控制面板”。
  - 单击“管理工具”，然后双击“Internet Information Services (IIS)管理器”。
- 如果使用的是 Windows Server 2008 或 Windows Server 2008 R2：
  - 在任务栏上，单击“开始”，指向“管理工具”，然后单击“Internet Information Services (IIS)管理器”。
- 如果使用的是 Windows Vista 或 Windows 7：
  - 在任务栏上，单击“开始”，然后单击“控制面板”。
  - 双击“管理工具”，然后双击“Internet Information Services (IIS)管理器”。
在“连接”窗格中，展开服务器名称，展开“站点”，展开要向其添加虚拟目录的网站，然后单击要向其添加虚拟目录的应用程序。
在“操作”窗格中，单击“查看虚拟目录”，然后单击“添加虚拟目录...”
在“添加虚拟目录”对话框中，至少在“别名:”和“物理路径:”文本框中输入信息，然后单击“确定”。

注意

可以单击“连接身份...”，将服务器配置为在访问虚拟目录中的内容时使用指定的凭据，然后单击“测试设置...”以测试虚拟目录的身份验证和授权设置。

配置

<virtualDirectory> 元素可在 ApplicationHost.config 文件中的服务器、站点和应用程序级别进行配置。

特性

属性说明

allowSubDirConfig 可选布尔属性。

指定 IIS 是在低于当前级别的内容目录中查找 Web.config 文件 (true)，还是不在低于当前级别的内容目录中查找 Web.config 文件 (false)。

默认值为 true。

logonMethod

可选枚举属性。

指定虚拟目录的登录方法。

logonMethod 属性可以是下列可能值之一。默认为 ClearText。

值	说明
`Batch`	此登录类型适用于批处理服务器，无需用户直接干预即可代表用户执行进程。数值为 `1`。
`ClearText`	此登录类型保留身份验证包中的姓名和密码，从而允许服务器在模拟客户端时连接到其他网络服务器。数值为 `3`。
`Interactive`	此登录类型适用于以交互方式使用计算机的用户。数值为 `0`。
`Network`	此登录类型适用于进行明文密码身份验证的高性能服务器。不会缓存此登录类型的凭据。数值为 `2`。

password 可选的字符串属性。

指定与用户名关联的密码。

注意：为避免在配置文件中存储未加密的密码字符串，请始终使用 AppCmd.exe 或 IIS 管理器输入密码。如果使用这些管理工具，密码字符串将在写入 XML 配置文件之前自动进行加密。与存储未加密的密码相比，这种方式提供的密码安全性更高。

path 可选的字符串属性。

指定虚拟目录的虚拟路径。

physicalPath 可选的字符串属性。

指定虚拟目录的物理路径。

userName 可选的字符串属性。

指定可以访问此虚拟目录的配置文件和内容的帐户的用户名。

子元素

无。

配置示例

以下配置示例显示了包含两个应用程序的 <site> 元素。第一个 <application> 元素定义站点的根应用程序，以及应用程序的根虚拟目录。第二个 <application> 元素包含网站上的 CRM 应用程序的配置设置。路径属性定义应用程序的路径。此 <application> 元素包含两个 <virtualDirectory> 元素。第一个定义应用程序的根虚拟目录，第二个定义应用程序的 Images 虚拟目录。

<site name="Contoso" id="2" serverAutoStart="true">
   <application path="/">
      <virtualDirectory path="/" physicalPath="C:\Contoso\Content" />
   </application>
   <application path="/CRM">
      <virtualDirectory path="/" physicalPath="C:\Contoso\Content\CRM" />
      <virtualDirectory path="/Images" physicalPath="E:\Images" />
   </application>
   <bindings>
      <binding protocol="http" bindingInformation="*:80:www.contoso.com" />
   </bindings>
</site>

代码示例

以下示例为名为 Contoso 的站点新建了一个名为 ShoppingCart 的应用程序，其虚拟目录根目录为 C:\Inetpub\Contoso\ShoppingCart。

注意

从命令提示符或脚本创建应用程序时，必须显式创建应用程序的根虚拟目录。

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /+"[name='Contoso'].[path='/ShoppingCart']" /commit:apphost

appcmd.exe set config -section:system.applicationHost/sites /+"[name='Contoso'].[path='/ShoppingCart'].[path='/',physicalPath='C:\Inetpub\Contoso\ShoppingCart']" /commit:apphost

注意

使用 AppCmd.exe 配置这些设置时，必须确保将 commit 参数设置为 apphost。这会将配置设置提交到 ApplicationHost.config 文件中的相应位置部分。

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection sitesSection = config.GetSection("system.applicationHost/sites");
         ConfigurationElementCollection sitesCollection = sitesSection.GetCollection();
         ConfigurationElement siteElement = FindElement(sitesCollection, "site", "name", @"Contoso");

         if (siteElement == null) throw new InvalidOperationException("Element not found!");

         ConfigurationElementCollection siteCollection = siteElement.GetCollection();
         ConfigurationElement applicationElement = siteCollection.CreateElement("application");

         applicationElement["path"] = @"/ShoppingCart";
         ConfigurationElementCollection applicationCollection = applicationElement.GetCollection();
         ConfigurationElement virtualDirectoryElement = applicationCollection.CreateElement("virtualDirectory");
         virtualDirectoryElement["path"] = @"/";
         virtualDirectoryElement["physicalPath"] = @"C:\Inetpub\Contoso\ShoppingCart";
         applicationCollection.Add(virtualDirectoryElement);
         siteCollection.Add(applicationElement);

         serverManager.CommitChanges();
      }
   }

   private static ConfigurationElement FindElement(ConfigurationElementCollection collection, string elementTagName, params string[] keyValues)
   {
      foreach (ConfigurationElement element in collection)
      {
         if (String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase))
         {
            bool matches = true;
            for (int i = 0; i < keyValues.Length; i += 2)
            {
               object o = element.GetAttributeValue(keyValues[i]);
               string value = null;
               if (o != null)
               {
                  value = o.ToString();
               }
               if (!String.Equals(value, keyValues[i + 1], StringComparison.OrdinalIgnoreCase))
               {
                  matches = false;
                  break;
               }
            }
            if (matches)
            {
               return element;
            }
         }
      }
      return null;
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample
   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim sitesSection As ConfigurationSection = config.GetSection("system.applicationHost/sites")
      Dim sitesCollection As ConfigurationElementCollection = sitesSection.GetCollection
      Dim siteElement As ConfigurationElement = FindElement(sitesCollection, "site", "name", "Contoso")

      If (siteElement Is Nothing) Then
         Throw New InvalidOperationException("Element not found!")
      End If

      Dim siteCollection As ConfigurationElementCollection = siteElement.GetCollection
      Dim applicationElement As ConfigurationElement = siteCollection.CreateElement("application")
      applicationElement("path") = "/ShoppingCart"
      Dim applicationCollection As ConfigurationElementCollection = applicationElement.GetCollection
      Dim virtualDirectoryElement As ConfigurationElement = applicationCollection.CreateElement("virtualDirectory")
      virtualDirectoryElement("path") = "/"
      virtualDirectoryElement("physicalPath") = "C:\Inetpub\Contoso\ShoppingCart"
      applicationCollection.Add(virtualDirectoryElement)
      siteCollection.Add(applicationElement)

      serverManager.CommitChanges()
   End Sub

   Private Function FindElement(ByVal collection As ConfigurationElementCollection, ByVal elementTagName As String, ByVal ParamArray keyValues() As String) As ConfigurationElement
      For Each element As ConfigurationElement In collection
         If String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase) Then
            Dim matches As Boolean = True
            Dim i As Integer
            For i = 0 To keyValues.Length - 1 Step 2
               Dim o As Object = element.GetAttributeValue(keyValues(i))
               Dim value As String = Nothing
               If (Not (o) Is Nothing) Then
                  value = o.ToString
               End If
               If Not String.Equals(value, keyValues((i + 1)), StringComparison.OrdinalIgnoreCase) Then
                  matches = False
                  Exit For
               End If
            Next
            If matches Then
               Return element
            End If
         End If
      Next
      Return Nothing
   End Function


End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST");
var sitesCollection = sitesSection.Collection;
var siteElementPos = FindElement(sitesCollection, "site", ["name", "Contoso"]);

if (siteElementPos == -1) throw "Element not found!";

var siteElement = sitesCollection.Item(siteElementPos);
var siteCollection = siteElement.Collection;
var applicationElement = siteCollection.CreateNewElement("application");
applicationElement.Properties.Item("path").Value = "/ShoppingCart";
var applicationCollection = applicationElement.Collection;
var virtualDirectoryElement = applicationCollection.CreateNewElement("virtualDirectory");
virtualDirectoryElement.Properties.Item("path").Value = "/";
virtualDirectoryElement.Properties.Item("physicalPath").Value = "C:\\Inetpub\\Contoso\\ShoppingCart";
applicationCollection.AddElement(virtualDirectoryElement);
siteCollection.AddElement(applicationElement);

adminManager.CommitChanges();

function FindElement(collection, elementTagName, valuesToMatch) {
   for (var i = 0; i < collection.Count; i++) {
      var element = collection.Item(i);
      if (element.Name == elementTagName) {
         var matches = true;
         for (var iVal = 0; iVal < valuesToMatch.length; iVal += 2) {
            var property = element.GetPropertyByName(valuesToMatch[iVal]);
            var value = property.Value;
            if (value != null) {
               value = value.toString();
            }
            if (value != valuesToMatch[iVal + 1]) {
               matches = false;
               break;
            }
         }
         if (matches) {
            return i;
         }
      }
   }
   return -1;
}

VBScript

Set adminManager = CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")
Set sitesCollection = sitesSection.Collection
siteElementPos = FindElement(sitesCollection, "site", Array("name", "Contoso"))

If (siteElementPos = -1) Then
   WScript.Echo "Element not found!"
   WScript.Quit
End If

Set siteElement = sitesCollection.Item(siteElementPos)
Set siteCollection = siteElement.Collection
Set applicationElement = siteCollection.CreateNewElement("application")
applicationElement.Properties.Item("path").Value = "/ShoppingCart"
Set applicationCollection = applicationElement.Collection
Set virtualDirectoryElement = applicationCollection.CreateNewElement("virtualDirectory")
virtualDirectoryElement.Properties.Item("path").Value = "/"
virtualDirectoryElement.Properties.Item("physicalPath").Value = "C:\Inetpub\Contoso\ShoppingCart"
applicationCollection.AddElement(virtualDirectoryElement)
siteCollection.AddElement(applicationElement)

adminManager.CommitChanges()

Function FindElement(collection, elementTagName, valuesToMatch)
   For i = 0 To CInt(collection.Count) - 1
      Set element = collection.Item(i)
      If element.Name = elementTagName Then
         matches = True
         For iVal = 0 To UBound(valuesToMatch) Step 2
            Set property = element.GetPropertyByName(valuesToMatch(iVal))
            value = property.Value
            If Not IsNull(value) Then
               value = CStr(value)
            End If
            If Not value = CStr(valuesToMatch(iVal + 1)) Then
               matches = False
               Exit For
            End If
         Next
         If matches Then
            Exit For
         End If
      End If
   Next
   If matches Then
      FindElement = i
   Else
      FindElement = -1
   End If
End Function

通过