語言

Control.ResolveUrl(String) 方法

定義

命名空間:
System.Web.UI
組件:
System.Web.dll

將一個網址轉換成請求客戶端可用的網址。

public:
 System::String ^ ResolveUrl(System::String ^ relativeUrl);
public string ResolveUrl(string relativeUrl);
member this.ResolveUrl : string -> string
Public Function ResolveUrl (relativeUrl As String) As String

參數

relativeUrl
String

與該屬性相關的 TemplateSourceDirectory 網址。

傳回

String

轉換後的網址。

例外狀況

ArgumentNullException

當參數 relativeUrl 包含 null時發生。

範例

以下範例建立一個 Image 網頁伺服器控制物件，並使用該 ResolveUrl 方法設定影像路徑，該路徑由屬性儲存 ImageUrl 。

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);         
   }     
}

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

備註

若參數 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 解析為絕對網址。 回傳的網址是供用戶端使用。

欲了解更多網站資源路徑的資訊，請參閱 ASP.NET Web 專案路徑。

Note

僅限於行動網頁，若您的應用程式依賴無 Cookie 會話，或可能收到需要無 Cookie 會話的行動瀏覽器請求，在路徑中使用波浪號（「~」）可能會導致不小心建立新會話，並可能遺失會話資料。 要設定一個帶有路徑的屬性，例如「~/path」，先用參數呼叫 ， ResolveUrl 例如「~/path」 ，然後再將其指派給該屬性。

適用於

另請參閱