Control.MapPathSecure(String) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
擷取虛擬路徑(絕對或相對)所對應的物理路徑。
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。
傳回
指向所請求檔案的實體路徑。
例外狀況
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。 這有助於防止安全漏洞。