Control.MapPathSecure(String) 方法

定義

命名空間:

System.Web.UI

組件:

System.Web.dll

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

protected public:
 System::String ^ MapPathSecure(System::String ^ virtualPath);

protected internal string MapPathSecure(string virtualPath);

member this.MapPathSecure : string -> string

Protected Friend Function MapPathSecure (virtualPath As String) As String

參數

virtualPath

String

一個 relative（relative）或根 relation URL。

傳回

String

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

例外狀況

ArgumentNullException

virtualPath 是 null 空字串（“”）。

範例

以下範例使用此 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。 這有助於防止安全漏洞。