Aracılığıyla paylaş

Control.ResolveUrl(String) Yöntem

Tanım

Ad Alanı:
System.Web.UI
Bütünleştirilmiş Kod:
System.Web.dll

URL'yi istekte bulunan istemcide kullanılabilen url'ye dönüştürür.

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

Parametreler

relativeUrl
String

Özelliğiyle TemplateSourceDirectory ilişkilendirilmiş URL.

Döndürülenler

String

Dönüştürülen URL.

Özel durumlar

ArgumentNullException

relativeUrl parametresi içeriyorsa nulloluşur.

Örnekler

Aşağıdaki örnek bir Image Web sunucusu denetim nesnesi oluşturur ve özelliği tarafından ImageUrl depolanan görüntünün yolunu ayarlamak için yöntemini kullanırResolveUrl.

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

Açıklamalar

relativeUrl Parametre mutlak bir URL içeriyorsa, URL değişmeden döndürülür. relativeUrl Parametre göreli bir URL içeriyorsa, tarayıcının URL'yi çözümleyebilmesi için bu URL geçerli istek yolu için doğru olan göreli BIR URL'ye değiştirilir.

Örneğin, şu senaryoyu inceleyin:

  • İstemci, kendisiyle ilişkilendirilmiş bir görüntüye sahip bir kullanıcı denetimi içeren bir ASP.NET sayfası istedi.

  • ASP.NET sayfası /Store/page1.aspx konumunda bulunur.

  • Kullanıcı denetimi /Store/UserControls/UC1.ascx konumunda bulunur.

  • Görüntü dosyası /UserControls/Images/Image1.jpgkonumunda bulunur.

Kullanıcı denetimi görüntüye göreli yolu (/Store/UserControls/Images/Image1.jpg) yöntemine ResolveUrl geçirirse, yöntem /Images/Image1.jpgdeğerini döndürür.

Bu yöntem, TemplateSourceDirectory mutlak URL'ye çözümlemek için özelliğini kullanır. Döndürülen URL istemci kullanımına yöneliktir.

Web sitesindeki kaynak yolları hakkında daha fazla bilgi için bkz. web projesi yollarını ASP.NET.

Uyarı

Yalnızca mobil Web sayfaları için, uygulamanız tanımlama bilgisiz oturumlara dayalıysa veya tanımlama bilgisi olmayan oturumlar gerektiren mobil tarayıcılardan istekler alabiliyorsa, bir yolda tilde ("~") kullanmak yanlışlıkla yeni bir oturum oluşturma ve oturum verilerini kaybetme olasılığına neden olabilir. "~/path" gibi bir yola sahip bir özellik ayarlamak için, özelliğine atamadan önce yolunu "~/path" gibi bir bağımsız değişkenle çağırarak ResolveUrl çözün.

Şunlara uygulanır

Ayrıca bkz.