Control.MapPathSecure(String) Méthode

Définition

Espace de noms:

System.Web.UI

Assembly:

System.Web.dll

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

protected:
 System::String ^ MapPathSecure(System::String ^ virtualPath);

protected public:
 System::String ^ MapPathSecure(System::String ^ virtualPath);

protected string MapPathSecure (string virtualPath);

protected internal string MapPathSecure (string virtualPath);

member this.MapPathSecure : string -> string

Protected Function MapPathSecure (virtualPath As String) As String

Protected Friend Function MapPathSecure (virtualPath As String) As String

Paramètres

virtualPath

String

URL relative ou relative à la racine.

Retours

String

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

Exceptions

ArgumentNullException

virtualPath ou null est une chaîne vide ("").

Exemples

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

// 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(TemplateSourceDirectory) & "<br>")

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

' List all the files.
Dim i As Integer
For i = 0 To myFiles.Length - 1
   output.Write(myFiles(i) & "<br>")
Next i

Remarques

Cette méthode ne peut être utilisée que par les contrôles serveur qui disposent d’autorisations pour lire des fichiers et qui font partie de fichiers .dll entièrement approuvés, tels que System.Web.dll. Cela permet d’éviter les violations de sécurité.