Control.MapPathSecure(String) Metoda

Definicja

Przestrzeń nazw:

System.Web.UI

Zestaw:

System.Web.dll

Pobiera ścieżkę fizyczną, z którą mapuje się ścieżka wirtualna , bezwzględna lub względna.

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

Względny lub główny względny adres URL.

Zwraca

String

Ścieżka fizyczna do żądanego pliku.

Wyjątki

ArgumentNullException

virtualPath jest null lub pusty ciąg ("").

Przykłady

W poniższym przykładzie MapPathSecure użyto metody w celu uzyskania ścieżki fizycznej katalogu wirtualnego zawierającego Page obiekt lub UserControl .

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

Uwagi

Tej metody można używać tylko przez kontrolki serwera, które mają uprawnienia do odczytu plików i które są częścią w pełni zaufanych plików .dll, takich jak System.Web.dll. Pomaga to zapobiegać naruszeniom zabezpieczeń.