HttpServerUtility.MapPath(String) Metode

Definisi

Ruang nama:

System.Web

Rakitan:

System.Web.dll

Mengembalikan jalur file fisik yang sesuai dengan jalur virtual yang ditentukan.

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

Parameter

path

String

Jalur virtual di aplikasi Web.

Mengembalikan

String

Jalur file fisik di server Web yang sesuai dengan path.

Pengecualian

HttpException

Saat ini HttpContext adalah null.

-atau-

path adalah jalur fisik, tetapi jalur virtual diharapkan.

Contoh

Contoh berikut menunjukkan cara mengambil file fisik dari jalur virtual relatif. Kode berada di file code-behind untuk halaman web dan menggunakan objek default Server .

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

Contoh berikutnya mirip dengan contoh sebelumnya kecuali menunjukkan cara mengambil jalur fisik dari dalam kelas yang tidak ada di file code-behind.

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

Keterangan

Jika path adalah null, MapPath metode mengembalikan jalur fisik lengkap direktori yang berisi permintaan saat ini untuk jalur tersebut. Jalur relatif tidak perlu menentukan file atau folder yang ada agar metode ini mengembalikan nilai. Namun, Anda tidak dapat menentukan jalur di luar aplikasi Web.

Important

Metode ini MapPath berpotensi berisi informasi sensitif tentang lingkungan hosting. Nilai pengembalian tidak boleh ditampilkan kepada pengguna.

Aplikasi Web yang berada di C:\ExampleSites\TestMapPath akan mengembalikan hasil berikut:

Permintaan dari	path	Nilai yang dikembalikan
RootLevelPage.aspx	null	C:\ExampleSites\TestMapPath
RootLevelPage.aspx	"/DownOneLevel/DownLevelPage.aspx"	C:\ExampleSites\TestMapPath\DownOneLevel\DownLevelPage.aspx
RootLevelPage.aspx	"/NotRealFolder"	C:\ExampleSites\TestMapPath\NotRealFolder
RootLevelPage.aspx	".. /OutsideApplication"	HttpException
/DownOneLevel/DownLevelPage.aspx	null	C:\ExampleSites\TestMapPath\DownOneLevel
/DownOneLevel/DownLevelPage.aspx	".. /RootLevelPage.aspx"	C:\ExampleSites\TestMapPath\RootLevelPage.aspx