HttpServerUtility.MapPath(String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
Chemin du fichier physique sur le serveur web correspondant à path
.
Exceptions
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 null
le 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 |