HttpRequest.ApplicationPath 屬性

定義

取得 ASP.NET 應用程式在伺服器上的虛擬應用程式根路徑。Gets the ASP.NET application's virtual application root path on the server.

public:
 property System::String ^ ApplicationPath { System::String ^ get(); };
public string ApplicationPath { get; }
member this.ApplicationPath : string
Public ReadOnly Property ApplicationPath As String

屬性值

String

目前應用程式的虛擬路徑。The virtual path of the current application.

範例

下列範例會使用 Write 方法來進行 HTML 編碼,然後將屬性的值寫入 ApplicationPath 文字檔。The following example uses the Write method to HTML-encode and then write the value of the ApplicationPath property to a text file. 這個程式碼範例是針對類別提供之較大範例的一部分 HttpRequestThis code example is part of a larger example provided for the HttpRequest class. 它會假設有一個 StreamWriter 名為的物件存在 swIt assumes the existence of a StreamWriter object named sw.

// Write request information to the file with HTML encoding.
sw.WriteLine(Server.HtmlEncode(DateTime.Now.ToString()));
sw.WriteLine(Server.HtmlEncode(Request.CurrentExecutionFilePath));
sw.WriteLine(Server.HtmlEncode(Request.ApplicationPath));
sw.WriteLine(Server.HtmlEncode(Request.FilePath));
sw.WriteLine(Server.HtmlEncode(Request.Path));
' Write request information to the file with HTML encoding.
sw.WriteLine(Server.HtmlEncode(DateTime.Now.ToString()))
sw.WriteLine(Server.HtmlEncode(Request.CurrentExecutionFilePath))
sw.WriteLine(Server.HtmlEncode(Request.ApplicationPath))
sw.WriteLine(Server.HtmlEncode(Request.FilePath))
sw.WriteLine(Server.HtmlEncode(Request.Path))

下列範例 ApplicationPath 會使用屬性,以程式設計方式,在應用程式中的固定位置建立資源的路徑。The following example uses the ApplicationPath property to programmatically construct a path to a resource that is in a fixed location in the application. 參考資源的頁面不一定要位於與資源相同的目錄中。The page that references the resource does not have to be located in the same directory as the resource.

<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    protected void Page_Load(object sender, EventArgs e)
    {
        Label1.Text = Request.ApplicationPath;
        Image1.ImageUrl = Request.ApplicationPath + "/images/Image1.gif";
        Label2.Text = Image1.ImageUrl;
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpRequest.ApplicationPath Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        ApplicationPath:<br />
        <asp:Label ID="Label1" runat="server" ForeColor="Brown" /><br />

        <asp:Image ID="Image1" runat="server" /><br />

        ImageUrl:<br />
        <asp:Label ID="Label2" runat="server" ForeColor="Brown" />
        <br />
        </div>
    </form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
        Label1.Text = Request.ApplicationPath
        Image1.ImageUrl = Request.ApplicationPath + "/images/Image1.gif"
        Label2.Text = Image1.ImageUrl
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpRequest.ApplicationPath Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        ApplicationPath:<br />
        <asp:Label ID="Label1" runat="server" ForeColor="Brown" /><br />

        <asp:Image ID="Image1" runat="server" />

        ImageUrl:<br />
        <asp:Label ID="Label2" runat="server" ForeColor="Brown" />
        <br />
     </div>
    </form>
</body>
</html>

如果您在名為 WebSite1 的 Web 應用程式中執行此範例, /WebSite1 將會顯示為屬性的值 ApplicationPath ,並 /WebSite1/images/Image1.gif 將顯示為影像的完整路徑。If you run this example in a Web application that is named WebSite1, /WebSite1 will be displayed as the value of the ApplicationPath property and /WebSite1/images/Image1.gif will be displayed as the complete path of the image.

備註

您可以使用這個屬性,從不在根目錄中的頁面或 Web 使用者控制項,建立相對於應用程式根目錄的 URL。Use this property to construct a URL relative to the application root from a page or Web user control that is not in the root directory. 這可讓存在於目錄結構不同層級的頁面和共用控制項使用相同的程式碼,以連結至應用程式中固定位置的資源。This allows pages and shared controls that exist at different levels of a directory structure to use the same code to link to resources at fixed locations in the application.

適用於