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á pro žadatele 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ří ovládací objekt webového Image serveru a použije ResolveUrl metodu k nastavení cesty 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 třeba následující scénář:

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

  • Stránka ASP.NET se nachází na adrese /Store/page1.aspx.

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

  • Soubor image 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) metodě ResolveUrl , 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 najdete v tématu ASP.NET Cesty k webu Project.

Poznámka

U mobilních webových stránek může aplikace spoléhat pouze 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, pomocí tildy ("~") v cestě může způsobit neúmyslně vytvoření nové relace a potenciálně ztrátu dat relace. Pokud chcete nastavit vlastnost s cestou, například~/ "path", přeložte cestu voláním ResolveUrl argumentu, například~/ "path" před jeho přiřazením k vlastnosti.

Platí pro

Viz také