ASP.NET 网站路径 Web 应用程序根目录运算符 ~

原文：http://msdn.microsoft.com/zh-cn/library/ms178116(v=VS.90).aspx

 

指定资源的路径

许多情况下，页面中的元素或控件必须引用外部资源，如文件。ASP.NET 支持引用外部资源的各种方法。根据您使用的是客户端元素还是 Web 服务器控件，选择的引用方法将有所不同。

客户端元素

客户端元素是页面上的非 Web 服务器控件元素，它们将按原样被传递给浏览器。因此，从客户端元素中引用资源时，应根据 HTML 中 URL 的标准规则构造路径。可以使用完全限定的 URL 路径（又称为绝对 URL 路径），也可以使用各种类型的相对路径。例如，如果页面包含 img 元素，则可以使用以下路径之一设置其 src 属性：

• 绝对 URL 路径。如果引用其他位置（例如外部网站）中的资源，则绝对 URL 路径非常有用。

  <img src="http://www.contoso.com/MyApplication/Images/SampleImage.jpg" />
  

• 网站根目录相对路径，此路径将根据网站根目录（而非应用程序根目录）进行解析。如果将跨应用程序的资源（例如图像或客户端脚本文件）保留在网站根目录下的文件夹中，则网站根目录相对路径非常有用。

  此示例路径假定 Images 文件夹位于网站根目录下。

  <img src="/Images/SampleImage.jpg" />
  

  如果您的网站为 http://www.contoso.com，则此路径将解析为以下形式。

  http://www.contoso.com/Images/SampleImage.jpg
  

• 下面是一个根据当前页面路径解析的相对路径。

  <img src="Images/SampleImage.jpg" />
  

• 解析为当前页面路径对等的相对路径。

  <img src="../Images/SampleImage.jpg" />
  

  说明：
  默认情况下，浏览器使用当前页面的 URL 作为解析相对路径的基准。但是，您可以在页面中包含 HTML base 元素，以指定替代基路径。

 

服务器控件

在引用资源的 ASP.NET 服务器控件中，可以使用绝对路径或相对路径，这一点与客户端元素一样。如果使用相对路径，则相对于页面、用户控件或包含该控件的主题的路径进行解析。例如，假设 Controls 文件夹中包含一个用户控件。该用户控件包含一个 Image Web 服务器控件，此服务器控件的 ImageUrl 属性被设置为以下路径：Images/SampleImage.jpg。

当该用户控件运行时，上述路径将解析为以下形式：/Controls/Images/SampleImage.jpg。无论承载该用户控件的页面位于何处，结果都是如此。

说明：
在主控页中，资源的路径基于内容页的路径进行解析。有关更多信息，请参见 ASP.NET 母版页概述。

服务器控件中的绝对和相对路径引用具有以下缺点：

• 绝对路径在应用程序之间是不可移植的。如果移动绝对路径指向的应用程序，则链接将会中断。

• 如果将资源或页面移动到不同的文件夹，可能很难维护采用客户端元素样式的相对路径。

为克服这些缺点，ASP.NET 包括了 Web 应用程序根目录运算符 (~)，当您在服务器控件中指定路径时可以使用该运算符。ASP.NET 会将 ~ 运算符解析为当前应用程序的根目录。可以结合使用 ~ 运算符和文件夹来指定基于当前根目录的路径。

下面的示例演示了使用 Image 服务器控件时用于为图像指定根目录相对路径的 ~ 运算符。在此示例中，无论页面位于网站中的什么位置，都将从位于 Web 应用程序根目录下的 Images 文件夹中直接读取图像文件。

<asp:image runat="server" id="Image1"
  ImageUrl="~/Images/SampleImage.jpg" />

可以在服务器控件中的任何与路径有关的属性中使用 ~ 运算符。~ 运算符只能为服务器控件识别，并且位于服务器代码中。不能将 ~ 运算符用于客户端元素。

说明：
仅限于移动页，如果您的应用程序依赖于无 Cookie 会话或者可能收到来自移动设备的需要无 Cookie 会话的请求，则在路径中使用波形符（“~”）会导致意外创建新会话，并可能丢失会话数据。若要使用包含波形符（例如“~/路径”）的路径来设置移动控件的属性，请先使用 ResolveUrl 方法解析该路径，再将其分配给该属性。

 

使用 MapPath 方法

MapPath 方法返回传递给该方法的虚拟路径的完整物理路径。例如，以下代码返回网站根目录的文件路径：

 

C#:String rootPath = Server.MapPath("~");

传递给 MapPath 方法的路径必须为应用程序相对路径，而不是绝对路径。

传递给 MapPath 方法的路径必须为应用程序相对路径，而不是绝对路径。

说明：传递给MapPath的路径必须是应用程序的相对路径，而不是绝对路径。

 

说明：
传递给 MapPath 方法的路径必须为应用程序相对路径，而不是绝对路径。

  
  
 说明： 
传递给 MapPath 方法的路径必须为应用程序相对路径，而不是绝对路径。
  
  

      
      
传递给 MapPath 方法的路径必须为应用程序相对路径，而不是绝对路径。
传递给 MapPath 方法的路径必须为应用程序相对路径，而不是绝对路径。
  
  

       
       
说明： 
传递给 MapPath 方法的路径必须为应用程序相对路径，而不是绝对路径。
说明： 
传递给 MapPath 方法的路径必须为应用程序相对路径，而不是绝对路径。