UserControl.MapPath メソッド

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

UserControl.MapPath メソッド

絶対仮想ファイル パスまたは相対仮想ファイル パスを物理ファイル パスに割り当てます。

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

Visual Basic (宣言)

Public Function MapPath ( _
    virtualPath As String _
) As String

Visual Basic (使用法)

Dim instance As UserControl
Dim virtualPath As String
Dim returnValue As String

returnValue = instance.MapPath(virtualPath)

C#

public string MapPath (
    string virtualPath
)

C++

public:
String^ MapPath (
    String^ virtualPath
)

J#

public String MapPath (
    String virtualPath
)

JScript

public function MapPath (
    virtualPath : String
) : String

パラメータ

virtualPath

割り当てる仮想ファイル パス。

戻り値
ファイルへの物理パス。

解説

このメソッドは、Page.MapPath メソッドと似ていますが、.aspx ファイルではなく .ascx ファイルの位置からのパスを割り当てます。このメソッドを使用して、UserControl オブジェクトに関連付けられたイメージその他のリソースのディレクトリへのパスを取得できます。

使用例

MapPath メソッドを呼び出して、myControl という名前のユーザー コントロールに関連付けられいている物理パスに、actualServerPath 変数を関連付ける例を次に示します。

Visual Basic

myControl.Response.Write("<br><b>The server code is
 running on machine</b> : " + myControl.Server.MachineName)
Dim actualServerPath As String
 = myControl.MapPath(myControl.Request.Path)

C#

 
myControl.Response.Write("<br><b>The server code is running on machine</b>
 : " + myControl.Server.MachineName);
string actualServerPath = myControl.MapPath(myControl.Request.Path);

J#

     
myControl.get_Response().Write("<br><b>The server code is"
 
    + "running on machine</b> : "
    + myControl.get_Server().get_MachineName());

String actualServerPath =
    myControl.MapPath(myControl.get_Request().get_Path());

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
UserControl クラス
UserControl メンバ
System.Web.UI 名前空間
Page.MapPath