HttpServerUtility.MapPath(String) HttpServerUtility.MapPath(String) HttpServerUtility.MapPath(String) HttpServerUtility.MapPath(String) Method

Definition

指定した仮想パスに対応する物理ファイル パスを返します。 Returns the physical file path that corresponds to the specified virtual path.

public:
 System::String ^ MapPath(System::String ^ path);
public string MapPath (string path);
member this.MapPath : string -> string
Public Function MapPath (path As String) As String

パラメーター

path
String String String String

Web アプリケーション内の仮想パス。 The virtual path in the Web application.

Returns

path に対応する、Web サーバー上の物理ファイル パス。 The physical file path on the Web server that corresponds to path.

Exceptions

現在の HttpContextnull です。 The current HttpContext is null. - または - -or- path は物理パスです。仮想パスを指定してください。 path is a physical path, but a virtual path was expected.

Examples

次の例では、物理ファイルの相対仮想パスを取得する方法を示します。The following example shows how to retrieve the physical file of a relative virtual path. コードは、web ページの分離コード ファイル内に存在し、既定値を利用してServerオブジェクト。The code resides in the code-behind file for a web page and utilizes the default Server object.

public partial class _Default : Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        string pathToFiles = Server.MapPath("/UploadedFiles");
    }
}
Public Class _Default
    Inherits Page

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
        Dim pathToFiles = Server.MapPath("/UploadedFiles")
    End Sub
End Class

次の例は、点を除いて、分離コード ファイルに含まれていないクラス内からの物理パスを取得する方法を示します、前の例に似ています。The next example is similar to the previous example except it shows how to retrieve a physical path from within a class that is not in the code-behind file.

public class SampleClass
{
    public string GetFilePath()
    {
        return HttpContext.Current.Server.MapPath("/UploadedFiles");
    }
}
Public Class SampleClass
    Public Function GetFilePath() As String
        Return HttpContext.Current.Server.MapPath("/UploadedFiles")
    End Function
End Class

Remarks

場合pathnullMapPathメソッドは、パスの現在の要求を含むディレクトリの完全な物理パスを返します。If path is null, the MapPath method returns the full physical path of the directory that contains the current request for the path. 相対パスは、既存のファイルまたはフォルダーの値を返すには、このメソッドを指定する必要はありません。The relative path does not need to specify an existing file or folder for this method to return a value. ただし、Web アプリケーションの外部でパスを指定することはできません。However, you cannot specify a path outside of the Web application.

重要

MapPathメソッドに可能性のあるホスティング環境に関する機密情報が含まれています。The MapPath method potentially contains sensitive information about the hosting environment. 戻り値は、ユーザーには表示されません。The return value should not be displayed to users.

Web アプリケーションに配置されているC:\ExampleSites\TestMapPath次の結果が返されます。A Web application that resides at C:\ExampleSites\TestMapPath would return the following results:

要求します。Request from path 戻り値Returned value
RootLevelPage.aspxRootLevelPage.aspx null C:\ExampleSites\TestMapPathC:\ExampleSites\TestMapPath
RootLevelPage.aspxRootLevelPage.aspx "/DownOneLevel/DownLevelPage.aspx""/DownOneLevel/DownLevelPage.aspx" C:\ExampleSites\TestMapPath\DownOneLevel\DownLevelPage.aspxC:\ExampleSites\TestMapPath\DownOneLevel\DownLevelPage.aspx
RootLevelPage.aspxRootLevelPage.aspx "/NotRealFolder""/NotRealFolder" C:\ExampleSites\TestMapPath\NotRealFolderC:\ExampleSites\TestMapPath\NotRealFolder
RootLevelPage.aspxRootLevelPage.aspx "../OutsideApplication""../OutsideApplication" HttpException
/DownOneLevel/DownLevelPage.aspx/DownOneLevel/DownLevelPage.aspx null C:\ExampleSites\TestMapPath\DownOneLevelC:\ExampleSites\TestMapPath\DownOneLevel
/DownOneLevel/DownLevelPage.aspx/DownOneLevel/DownLevelPage.aspx "../RootLevelPage.aspx""../RootLevelPage.aspx" C:\ExampleSites\TestMapPath\RootLevelPage.aspxC:\ExampleSites\TestMapPath\RootLevelPage.aspx

Applies to