Control.MapPathSecure メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Control.MapPathSecure メソッド

仮想パス (絶対パスまたは相対パス) の割り当て先の物理パスを取得します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Friend Function
 MapPathSecure ( _
    virtualPath As String _
) As String

Visual Basic (使用法)

Dim virtualPath As String
Dim returnValue As String

returnValue = Me.MapPathSecure(virtualPath)

protected internal string MapPathSecure (
    string virtualPath
)

C++

protected public:
String^ MapPathSecure (
    String^ virtualPath
)

protected String MapPathSecure (
    String virtualPath
)

JScript

protected internal function
 MapPathSecure (
    virtualPath : String
) : String

パラメータ

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

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

例外

例外の種類	条件
HttpException	サーバーコントロールに、割り当てられた結果のファイルを読み取るための許可がない場合に発生します。

解説

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

使用例

Page オブジェクトまたは UserControl オブジェクトが格納されている仮想ディレクトリの物理パスを、MapPathSecure メソッドを使用して取得する例を次に示します。

Visual Basic

' 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

// 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(get_TemplateSourceDirectory()) + "<br>");

// Get all the files from the absolute path of 'MyControl';
// using TemplateSourceDirectory which gives the virtual Directory.
String myFiles[] = Directory.GetFiles(MapPathSecure(
    get_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.get_Item(i) + "<br>");
}