Control.ResolveUrl(String) Yöntem

Başvuru

Tanım

Ad Alanı:: System.Web.UI

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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 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 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öntemine ResolveUrl geçirirse, yöntem /Images/Image1.jpg değ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.

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

Not

Yalnızca mobil Web sayfaları için, uygulamanız tanımlama bilgisi olmayan oturumları kullanıyorsa veya mobil tarayıcılardan tanımlama bilgisi olmayan oturumlar gerektiren istekler alıyorsa, 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 ResolveUrl atamadan önce yolunu "~/path" gibi bir bağımsız değişkenle çağırarak çözümle.

Şunlara uygulanır

Ürün	Sürümler
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Aracılığıyla paylaş