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

相対 URL、またはルートに対して相対的な URL。

戻り値

String

要求されたファイルへの物理パス。

例外

virtualPathnull または空の文字列 ("") です。

次の例では、このメソッドをMapPathSecure使用して、包含またはUserControlオブジェクトの仮想ディレクトリの物理パスをPage取得します。

// 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

注釈

このメソッドは、ファイルを読み取るアクセス許可を持ち、System.Web.dllなどの完全に信頼された.dll ファイルの一部であるサーバー コントロールでのみ使用できます。 これにより、セキュリティ侵害の防止に役立ちます。

適用対象