Control.MapPathSecure(String) Metoda

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

Načte fyzickou cestu, na kterou se virtuální cesta mapuje buď absolutní, nebo relativní.

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

Parametry

virtualPath

String

Relativní nebo kořenová relativní adresa URL.

Návraty

String

Fyzická cesta k požadovanému souboru.

Výjimky

ArgumentNullException

virtualPath je null nebo prázdný řetězec ("").

Příklady

Následující příklad používá metodu MapPathSecure k získání fyzické cesty virtuálního adresáře obsahujícího Page nebo UserControl objektu.

// 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

Poznámky

Tuto metodu lze používat pouze ovládacími prvky serveru, které mají oprávnění ke čtení souborů a které jsou součástí plně důvěryhodných .dll souborů, jako je System.Web.dll. To pomáhá zabránit narušení zabezpečení.