Control.ResolveUrl(String) Metoda

  • Reference

Definice

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

Převede adresu URL na adresu URL, která je použitelná v žádajícím klientovi.

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

Vyvolá se, relativeUrl pokud parametr obsahuje null.

Příklady

Následující příklad vytvoří Image objekt ovládacího prvku webového ResolveUrl serveru a pomocí metody nastaví cestu k bitové kopii, která je uložena ImageUrl vlastností .

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 ji prohlížeč mohl přeložit.

Představte si třeba následující scénář:

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

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

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

  • Soubor bitové kopie 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ě, metoda vrátí 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í klientem.

Další informace o cestách zdrojů na webu naleznete v tématu ASP.NET cesty webového projektu.

Poznámka

Pouze u mobilních webových stránek platí, že pokud vaše aplikace spoléhá na relace bez souborů cookie nebo může přijímat požadavky 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. Pokud chcete nastavit vlastnost s cestou, jako je například ~/path, před přiřazením cesty k vlastnosti ji přeložte voláním ResolveUrl metody s argumentem , například ~/path .

Platí pro

Viz také