Поделиться через

Control.ResolveUrl(String) Метод

Определение

Пространство имен:
System.Web.UI
Сборка:
System.Web.dll

Преобразует URL-адрес в url-адрес, который можно использовать на запрашиваемом клиенте.

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

URL-адрес, связанный с свойством TemplateSourceDirectory .

Возвращаемое значение

String

Преобразованный URL-адрес.

Исключения

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/Images/Image1.jpg) ResolveUrl метод возвращает значение /Images/Image1.jpg.

Этот метод использует TemplateSourceDirectory свойство для разрешения абсолютного URL-адреса. Возвращенный URL-адрес предназначен для использования клиента.

Дополнительные сведения о путях ресурсов на веб-сайте см. в ASP.NET пути веб-проекта.

Замечание

Только для мобильных веб-страниц, если приложение использует сеансы без файлов cookie или может получать запросы от мобильных браузеров, требующих сеансов без файлов cookie, используя тильду (~) в пути, может привести к непреднамеренному созданию нового сеанса и потенциально потере данных сеанса. Чтобы задать свойство с таким путем, как ~/path, устраните путь, вызвав ResolveUrl аргумент, например ~/path, прежде чем назначить его свойству.

Применяется к

См. также раздел