HttpServerUtility.MapPath(String) Méthode

Définition

Espace de noms:

System.Web

Assembly:

System.Web.dll

Retourne le chemin d’accès au fichier physique qui correspond au chemin d’accès virtuel spécifié.

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

Paramètres

path

String

Chemin d’accès virtuel dans l’application web.

Retours

String

Chemin du fichier physique sur le serveur web correspondant à path.

Exceptions

HttpException

Le HttpContext actuel a la valeur null.

• ou - path est un chemin physique, mais un chemin virtuel était attendu.

Exemples

L’exemple suivant montre comment récupérer le fichier physique d’un chemin virtuel relatif. Le code réside dans le fichier code-behind d’une page web et utilise l’objet par défaut 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’exemple suivant est similaire à l’exemple précédent, sauf qu’il montre comment récupérer un chemin d’accès physique à partir d’une classe qui n’est pas dans le fichier 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

Remarques

Si path c’est nullle cas, la MapPath méthode retourne le chemin physique complet du répertoire qui contient la demande actuelle du chemin d’accès. Le chemin relatif n’a pas besoin de spécifier un fichier ou un dossier existant pour cette méthode pour retourner une valeur. Toutefois, vous ne pouvez pas spécifier de chemin d’accès en dehors de l’application web.

Important

La MapPath méthode contient potentiellement des informations sensibles sur l’environnement d’hébergement. La valeur de retour ne doit pas être affichée aux utilisateurs.

Une application web qui réside à C:\ExampleSites\TestMapPath retourner les résultats suivants :

Demande à partir de	path	Valeur renvoyée
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