HttpServerUtility.MapPath(String) Metodo

Definizione

Spazio dei nomi:

System.Web

Assembly:

System.Web.dll

Restituisce il percorso fisico al file che corrisponde al percorso virtuale specificato.

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

Parametri

path

String

Percorso virtuale nell'applicazione Web.

Restituisce

String

Percorso fisico del file nel server Web che corrisponde a path.

Eccezioni

HttpException

L'oggetto HttpContext corrente è null.

-oppure- path è un percorso fisico, mentre è previsto un percorso virtuale.

Esempio

Nell'esempio seguente viene illustrato come recuperare il file fisico di un percorso virtuale relativo. Il codice si trova nel file code-behind per una pagina Web e usa l'oggetto predefinito 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

L'esempio successivo è simile all'esempio precedente, ad eccezione di come recuperare un percorso fisico dall'interno di una classe che non è nel 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

Commenti

Se path è null, il MapPath metodo restituisce il percorso fisico completo della directory che contiene la richiesta corrente per il percorso. Il percorso relativo non deve specificare un file o una cartella esistente per questo metodo per restituire un valore. Non è tuttavia possibile specificare un percorso all'esterno dell'applicazione Web.

Importante

Il MapPath metodo contiene potenzialmente informazioni riservate sull'ambiente di hosting. Il valore restituito non deve essere visualizzato agli utenti.

Un'applicazione Web che risiede in C:\ExampleSites\TestMapPath restituisce i risultati seguenti:

Richiesta da	path	Valore restituito
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