Control.MapPathSecure(String) 方法

定義

擷取虛擬路徑(絕對或相對)所對應的物理路徑。

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

參數

virtualPath
String

一個 relative(relative)或根 relation URL。

傳回

指向所請求檔案的實體路徑。

例外狀況

virtualPathnull 空字串(“”)。

範例

以下範例使用此 MapPathSecure 方法取得包含 Page 物件 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

備註

此方法僅適用於擁有讀取檔案權限且屬於完全信任 .dll 檔案的伺服器控制項,例如 System.Web.dll。 這有助於防止安全漏洞。

適用於