Cette documentation est archivée et n’est pas conservée.

Control.MapPathSecure, méthode

Récupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond.

Espace de noms : System.Web.UI
Assembly : System.Web (dans system.web.dll)

protected internal string MapPathSecure (
	string virtualPath
)
protected String MapPathSecure (
	String virtualPath
)
protected internal function MapPathSecure (
	virtualPath : String
) : String

Paramètres

virtualPath

URL relative ou relative à la racine.

Valeur de retour

Chemin d'accès physique du fichier demandé.

Type d'exceptionCondition

HttpException

Se produit si le contrôle serveur ne dispose pas de l'autorisation de lire le fichier mappé obtenu.

Cette méthode ne peut être utilisée que par des contrôles serveur qui disposent des autorisations nécessaires pour lire les fichiers et qui font partie de fichiers .dll présentant un niveau de confiance suffisant, tels que System.Web.dll. Cela permet d'éviter toute violation de la sécurité.

L'exemple suivant utilise la méthode MapPathSecure pour obtenir le chemin d'accès physique d'un répertoire virtuel de l'objet Page ou UserControl conteneur.

// An HttpException occurs if the server control does not,;
// have permissions to read the resulting mapped file. 
     output.Write("The Actual Path of the virtual directory : "+
     MapPathSecure(TemplateSourceDirectory)+"<br>");

    // Get all the files from the absolute path of 'MyControl';
    // using TemplateSourceDirectory which gives the virtual Directory.
        string [] myFiles=
        Directory.GetFiles(MapPathSecure(TemplateSourceDirectory));
        output.Write("The files in this Directory are <br>");

         // List all the files.
         for (int i=0;i<myFiles.Length;i++)
            output.Write(myFiles[i]+"<br>");

// An HttpException occurs if the server control does not,;
// have permissions to read the resulting mapped file. 
output.Write("The Actual Path of the virtual directory : " 
    + MapPathSecure(get_TemplateSourceDirectory()) + "<br>");

// Get all the files from the absolute path of 'MyControl';
// using TemplateSourceDirectory which gives the virtual Directory.
String myFiles[] = Directory.GetFiles(MapPathSecure(
    get_TemplateSourceDirectory()));
output.Write("The files in this Directory are <br>");

// List all the files.
for (int i = 0; i < myFiles.length; i++) {
    output.Write(myFiles.get_Item(i) + "<br>");
}  

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0
Afficher: