Control.ResolveUrl(String) Yöntem

  • Başvuru

Tanım

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

URL'yi istekte bulunan istemcide kullanılabilen bir 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şkili URL.

Döndürülenler

String

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

Özel durumlar

ArgumentNullException

relativeUrl parametresi içeriyorsa nullgerçekleşir.

Ö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ştirilmeden döndürülür. relativeUrl Parametresi 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, aşağıdaki senaryoları düşünün:

  • İ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 konumundadır.

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

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

Kullanıcı denetimi görüntünün göreli yolunu (/Store/UserControls/Images/Image1.jpg) yönteme ResolveUrl geçirirse, yöntem /Images/Image1.jpg değerini döndürür.

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

Web sitesindeki kaynak yolları hakkında daha fazla bilgi için bkz. ASP.NET Web Project Yolları.

Not

Yalnızca mobil Web sayfaları için, uygulamanız tanımlama bilgisi olmayan oturumlara dayalıysa veya mobil tarayıcılardan tanımlama bilgisi olmayan oturumlar gerektiren istekler alabiliyorsa, bir yolda tilde ("~") kullanmak yanlışlıkla yeni bir oturum oluşturulmasına ve potansiyel olarak oturum verilerinin kaybolması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.