Control.ResolveUrl メソッド

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

Control.ResolveUrl メソッド

要求側クライアントで使用できる URL に変換します。

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

Visual Basic (宣言)

Public Function ResolveUrl ( _
    relativeUrl As String _
) As String

Visual Basic (使用法)

Dim instance As Control
Dim relativeUrl As String
Dim returnValue As String

returnValue = instance.ResolveUrl(relativeUrl)

C#

public string ResolveUrl (
    string relativeUrl
)

C++

public:
String^ ResolveUrl (
    String^ relativeUrl
)

J#

public String ResolveUrl (
    String relativeUrl
)

JScript

public function ResolveUrl (
    relativeUrl : String
) : String

パラメータ

relativeUrl

TemplateSourceDirectory プロパティに関連付けられた URL。

戻り値
変換後の URL。

例外

例外の種類	条件
ArgumentNullException	relativeUrl パラメータが null 参照 (Visual Basic では Nothing) を格納している場合に発生します。

解説

relativeUrl パラメータに絶対 URL が格納されている場合、その URL は変更されずに返されます。relativeUrl パラメータに相対 URL が格納されている場合は、ブラウザがその URL を解決できるように、URL は現在の要求のパスに対応する相対 URL に変更されます。

たとえば、次のシナリオについて考えてみます。

• クライアントは、イメージが関連付けられているユーザー コントロールを格納している ASP.NET ページを要求しています。

• ASP.NET ページは /Store/page1.aspx です。

• ユーザー コントロールは /Store/UserControls/UC1.ascx です。

• イメージ ファイルは /UserControls/Images/Image1.jpg です。

ユーザー コントロールがイメージへの相対パス (/Store/UserControls/Images/Image1.jpg) を ResolveUrl メソッドに渡すと、そのメソッドは /Images/Image1.jpg という値を返します。

このメソッドは TemplateSourceDirectory プロパティを使用して、絶対 URL に解決します。返された URL はクライアントで使用できます。

Web サイトのリソース パスの詳細については、「ASP.NET Web サイトのパス」を参照してください。

使用例

Image Web サーバー コントロール オブジェクトを作成し、ResolveUrl メソッドを使用して、ImageUrl プロパティに格納されているイメージのパスを設定する例を次に示します。

Visual Basic

Public Class MyResolveUrl
   Inherits Control
   Private _ImageUrl As String

   Public Property ImageUrl() As
 String
      Get
         Return _ImageUrl
      End Get
      Set
         _ImageUrl = value
      End Set
   End Property

   Protected Overrides Sub
 Render(output As HtmlTextWriter)
      Dim myImage As New
 System.Web.UI.WebControls.Image()
      ' Resolve Url.
      myImage.ImageUrl = ResolveUrl(Me.ImageUrl)
      myImage.RenderControl(output)
   End Sub
End Class

C#

public class MyResolveUrl:Control
{
   private string _ImageUrl;     
   public string ImageUrl
   {
      get
      {
         return _ImageUrl;
      }
      set
      {
         _ImageUrl = value;
      }
   }
   protected override void Render(HtmlTextWriter
 output)
   {           
      Image myImage = new Image();
      // Resolve Url.
      myImage.ImageUrl = ResolveUrl(this.ImageUrl);
      myImage.RenderControl(output);         
   }     
}

J#

public class MyResolveUrl extends Control
{
    private String _ImageUrl;

    /** @property 
     */
    public String get_ImageUrl()
    {
        return _ImageUrl;
    } //get_ImageUrl

    /** @property 
     */
    public void set_ImageUrl(String value)
    {
        _ImageUrl = value;
    } //set_ImageUrl

    protected void Render(HtmlTextWriter output)
    {
        Image myImage = new Image();

        // Resolve Url.
        myImage.set_ImageUrl(ResolveUrl(this.get_ImageUrl()));
        myImage.RenderControl(output);
    } //Render
} //MyResolveUrl

プラットフォーム

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

参照

関連項目
Control クラス
Control メンバ
System.Web.UI 名前空間
TemplateSourceDirectory
その他の技術情報
ASP.NET Web サイトのパス