HttpServerUtility.MapPath(String) Méthode

Définition

Retourne le chemin d’accès au fichier physique qui correspond au chemin d’accès virtuel spécifié.Returns the physical file path that corresponds to the specified virtual path.

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.The virtual path in the Web application.

Retours

String

Chemin du fichier physique sur le serveur web correspondant à path.The physical file path on the Web server that corresponds to path.

Exceptions

Le HttpContext actuel a la valeur null.The current HttpContext is null.

-ou--or- path est un chemin physique, mais un chemin virtuel était attendu.path is a physical path, but a virtual path was expected.

Exemples

L’exemple suivant montre comment récupérer le fichier physique d’un chemin d’accès virtuel relatif.The following example shows how to retrieve the physical file of a relative virtual path. Le code se trouve dans le fichier code-behind d’une page Web et utilise l’objet par défaut Server .The code resides in the code-behind file for a web page and utilizes the default Server object.

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.The next example is similar to the previous example except it shows how to retrieve a physical path from within a class that is not in the code-behind file.

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 a la valeur null , 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.If path is null, the MapPath method returns the full physical path of the directory that contains the current request for the path. Le chemin d’accès relatif n’a pas besoin de spécifier un fichier ou un dossier existant pour que cette méthode retourne une valeur.The relative path does not need to specify an existing file or folder for this method to return a value. Toutefois, vous ne pouvez pas spécifier un chemin d’accès en dehors de l’application Web.However, you cannot specify a path outside of the Web application.

Important

La MapPath méthode contient potentiellement des informations sensibles sur l’environnement d’hébergement.The MapPath method potentially contains sensitive information about the hosting environment. La valeur de retour ne doit pas être affichée aux utilisateurs.The return value should not be displayed to users.

Une application Web qui réside dans C:\ExampleSites\TestMapPath retourne les résultats suivants :A Web application that resides at C:\ExampleSites\TestMapPath would return the following results:

Demande deRequest from path Valeur renvoyéeReturned value
RootLevelPage. aspxRootLevelPage.aspx null C:\ExampleSites\TestMapPathC:\ExampleSites\TestMapPath
RootLevelPage. aspxRootLevelPage.aspx "/DownOneLevel/DownLevelPage.aspx""/DownOneLevel/DownLevelPage.aspx" C:\ExampleSites\TestMapPath\DownOneLevel\DownLevelPage.aspxC:\ExampleSites\TestMapPath\DownOneLevel\DownLevelPage.aspx
RootLevelPage. aspxRootLevelPage.aspx "/NotRealFolder""/NotRealFolder" C:\ExampleSites\TestMapPath\NotRealFolderC:\ExampleSites\TestMapPath\NotRealFolder
RootLevelPage. aspxRootLevelPage.aspx ".. /OutsideApplication""../OutsideApplication" HttpException
/DownOneLevel/DownLevelPage.aspx/DownOneLevel/DownLevelPage.aspx null C:\ExampleSites\TestMapPath\DownOneLevelC:\ExampleSites\TestMapPath\DownOneLevel
/DownOneLevel/DownLevelPage.aspx/DownOneLevel/DownLevelPage.aspx ".. /RootLevelPage.aspx""../RootLevelPage.aspx" C:\ExampleSites\TestMapPath\RootLevelPage.aspxC:\ExampleSites\TestMapPath\RootLevelPage.aspx

S’applique à