博客园  :: 首页  :: 新随笔  :: 联系 :: 订阅 订阅  :: 管理

ASP.NET Web 项目路径

Posted on 2011-04-07 11:34  itcfj  阅读(807)  评论(0编辑  收藏  举报

ASP.NET Web 项目路径

.NET Framework 4

使用 Web 项目中的资源时,通常必须指定资源的路径。 例如,您可以使用 URL 路径引用页面中的图像文件或网站中其他位置处的页面的 URL。 同样,Web 项目中的代码可以使用基于服务器的文件的物理文件路径对文件进行读写操作。 ASP.NET 提供用于引用资源并确定应用程序中的页面或其他资源的路径的方法。

许多情况下,页面中的元素或控件必须引用外部资源,如文件。 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" />
    

    如果网站的 URL 为 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" />

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

在应用程序中,您可能需要确定服务器上的文件或其他资源的路径。 例如,如果 Web 项目以编程方式对文本文件进行读写操作,则必须为用于读取和写入的方法提供该文件的完整物理路径。

将物理文件路径(例如 C:\Website\MyApplication)硬编码到应用程序中并不是很好的做法,因为如果移动或部署应用程序,将会更改这些路径。 此外,如果将站点部署到承载提供程序,您可能不会知道具体的物理路径。 但是,ASP.NET 为您提供了以编程方式获取 Web 项目中的任何物理文件路径的方法。 然后,您可以使用基文件路径创建所需资源的完整路径。 用于确定文件路径的两种最常用的 ASP.NET 功能是返回路径信息的 HttpRequest 对象的属性,以及 MapPath 方法。

注意 注意

不应将物理文件路径发送到客户端,因为它们可能会被恶意用户用来获取有关您的应用程序的信息。

根据请求属性确定路径

下表列出了 HttpRequest 对象的属性,这些属性帮助您确定应用程序中的资源的路径。

表中列出的示例基于下面的假设:

  • 已使用以下 URL 发出浏览器请求:http://www.contoso.com/MyApplication/MyPages/Default.aspx

  • 术语“虚拟路径”是指请求 URL 中跟在服务器标识符后面的部分;在此示例中,虚拟路径是指以下路径:/MyApplication/MyPages/Default.aspx

  • 网站根目录的物理路径为:C:\inetpub\wwwroot\MyApplication\

  • 该物理路径中包含一个名为 MyPages 的文件夹。

属性

说明

ApplicationPath

获取当前应用程序的根目录路径,无论在该应用程序中的什么位置请求该路径。 在此示例中,该属性将返回以下内容:/

CurrentExecutionFilePath

获取当前请求的虚拟路径。 它与 FilePath 属性的不同之处在于,如果请求已在服务器代码中被重定向,则 CurrentExecutionFilePath 就是正确的。 在此示例中,该属性将返回以下内容:/MyApplication/MyPages/Default.aspx

如果作为对 TransferExecute 进行调用的结果,您获取正在运行的代码中的属性,则路径将反映该代码的位置。

FilePath

获取当前请求的虚拟路径。 在此示例中,该属性将返回以下内容:/MyApplication/MyPages/Default.aspx

CurrentExecutionFilePath 属性不同的是,FilePath 不反映服务器端的传输。

Path

获取当前请求的虚拟路径。 在此示例中,该属性将返回以下内容:/MyApplication/MyPages/default.aspx

PhysicalApplicationPath

获取当前正在执行的应用程序的根目录的物理文件系统路径。 在此示例中,该属性将返回以下内容:C:\inetpub\wwwroot\

PhysicalPath

获取与请求的 URL 相对应的物理文件系统路径。 在此示例中,该属性将返回以下内容:C:\inetpub\wwwroot\MyApplication\MyPages\default.aspx

将虚拟路径转换为物理路径

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