Control.MapPathSecure(String) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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ń.

Dotyczy