Control.MapPathSecure(String) 方法

定义

命名空间:

System.Web.UI

程序集:

System.Web.dll

检索虚拟路径（绝对的或相对的）映射到的物理路径。

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

相对 URL 或相对于根的 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。 这有助于防止安全漏洞。