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 d’accès au fichier physique sur le serveur Web qui correspond à path.

Exceptions

HttpException

Le courant HttpContext est null.

-ou-

path est un chemin d’accès physique, mais un chemin virtuel a été 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 d’accès physique complet du répertoire qui contient la requête actuelle pour le chemin d’accès. Le chemin relatif n’a pas besoin de spécifier un fichier ou un dossier existant pour que cette méthode retourne 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 retourne les résultats suivants :

Demande de	path	Valeur retourné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