Sdílet prostřednictvím

Control.ResolveUrl(String) Metoda

Definice

Obor názvů:
System.Web.UI
Sestavení:
System.Web.dll

Převede adresu URL na adresu URL, která je použitelná u žádajícího klienta.

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

Parametry

relativeUrl
String

Adresa URL přidružená k TemplateSourceDirectory vlastnosti.

Návraty

String

Převedená adresa URL.

Výjimky

ArgumentNullException

Nastane, pokud relativeUrl parametr obsahuje null.

Příklady

Následující příklad vytvoří objekt ovládacího prvku webového Image serveru a pomocí ResolveUrl metody nastaví cestu k obrázku, který je uložen vlastností 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

Poznámky

relativeUrl Pokud parametr obsahuje absolutní adresu URL, vrátí se adresa URL beze změny. relativeUrl Pokud parametr obsahuje relativní adresu URL, změní se tato adresa URL na relativní adresu URL, která je správná pro aktuální cestu požadavku, aby prohlížeč mohl adresu URL přeložit.

Představte si například následující scénář:

  • Klient požádal o stránku ASP.NET, která obsahuje uživatelský ovládací prvek, který má přidružený obrázek.

  • Stránka ASP.NET se nachází v umístění /Store/page1.aspx.

  • Uživatelský ovládací prvek se nachází ve správě /Store/UserControls/UC1.ascx.

  • Soubor obrázku se nachází ve složce /UserControls/Images/Image1.jpg.

Pokud uživatelský ovládací prvek předá relativní cestu k obrázku (tj. /Store/UserControls/Images/Image1.jpg) ResolveUrl metodě, vrátí metoda hodnotu /Images/Image1.jpg.

Tato metoda používá TemplateSourceDirectory vlastnost k překladu na absolutní adresu URL. Vrácená adresa URL je určená pro použití klienta.

Další informace o cestách k prostředkům na webu naleznete v tématu ASP.NET Cesty k webovému projektu.

Poznámka:

Pouze u mobilních webových stránek, pokud vaše aplikace spoléhá na relace bez souborů cookie nebo může přijímat žádosti z mobilních prohlížečů, které vyžadují relace bez souborů cookie, může použití tildy (~) v cestě způsobit neúmyslné vytvoření nové relace a potenciálně ztrátu dat relace. Chcete-li nastavit vlastnost s cestou, jako je například ~/path, přeložte cestu voláním ResolveUrl argumentu, například ~/path, před přiřazením k vlastnosti.

Platí pro

Viz také