Control.MapPathSecure(String) Metoda

Definice

Načte fyzickou cestu, na kterou je namapována virtuální cesta, buď absolutní, nebo relativní.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

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 relativní adresa URL relativní ke kořenuA relative or root relative URL.

Návraty

String

Fyzická cesta k požadovanému souboru.The physical path to the requested file.

Výjimky

virtualPathje null nebo prázdný řetězec ("").virtualPath is null or an empty string ("").

Příklady

Následující příklad používá MapPathSecure metodu k získání fyzické cesty k virtuálnímu adresáři obsahujícího Page UserControl objekt nebo.The following example uses the MapPathSecure method to obtain the physical path of a virtual directory of the containing Page or UserControl object.

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

Tato metoda může být použita pouze serverovými ovládacími prvky, které mají oprávnění ke čtení souborů a které jsou součástí plně důvěryhodných souborů. dll, například System.Web.dll.This method can only be used by server controls that have permissions to read files and which are part of fully trusted .dll files, such as System.Web.dll. To pomáhá zabránit narušení zabezpečení.This helps prevent security breaches.

Platí pro