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 virtuel, absolu ou relatif, est mappé.

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

protected internal string MapPathSecure(string virtualPath);

member this.MapPathSecure : string -> string

Protected Friend Function MapPathSecure (virtualPath As String) As String

Paramètres

virtualPath

String

URL relative ou racine.

Retours

String

Chemin d’accès physique au fichier demandé.

Exceptions

ArgumentNullException

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

Exemples

L’exemple suivant utilise la MapPathSecure méthode pour obtenir le chemin d’accès 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 disposant 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é.