HttpServerUtility.MapPath(String) Yöntem

Tanım

Ad Alanı:

System.Web

Bütünleştirilmiş Kod:

System.Web.dll

Belirtilen sanal yola karşılık gelen fiziksel dosya yolunu döndürür.

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

Parametreler

path

String

Web uygulamasındaki sanal yol.

Döndürülenler

String

Web sunucusundaki öğesine karşılık gelen pathfiziksel dosya yolu.

Özel durumlar

HttpException

Geçerli olan HttpContext : null.

-veya- path fiziksel bir yoldur, ancak sanal yol beklenirdi.

Örnekler

Aşağıdaki örnekte, göreli bir sanal yolun fiziksel dosyasının nasıl alınacakları gösterilmektedir. Kod, bir web sayfasının arka planda kod dosyasında bulunur ve varsayılan Server nesneyi kullanır.

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

Sonraki örnek önceki örneğe benzer ancak arka planda kod dosyasında olmayan bir sınıftan fiziksel yol almayı gösterir.

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

Açıklamalar

ise path nullyöntemi, MapPath yol için geçerli isteği içeren dizinin tam fiziksel yolunu döndürür. Bu yöntemin bir değer döndürmesi için göreli yolun mevcut bir dosya veya klasör belirtmesi gerekmez. Ancak, Web uygulamasının dışında bir yol belirtemezsiniz.

Önemli

yöntemi, MapPath barındırma ortamı hakkında hassas bilgiler içerebilir. Dönüş değeri kullanıcılara görüntülenmemelidir.

konumunda C:\ExampleSites\TestMapPath bulunan bir Web uygulaması aşağıdaki sonuçları döndürür:

İstek:	path	Döndürülen değer
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