Control.ResolveUrl(String) Metode

Referensi

Definisi

Ruang nama:: System.Web.UI

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengonversi URL menjadi URL yang dapat digunakan pada klien yang meminta.

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

Parameter

relativeUrl: String

URL yang TemplateSourceDirectory terkait dengan properti .

Mengembalikan

String

URL yang dikonversi.

Pengecualian

ArgumentNullException

Terjadi jika relativeUrl parameter berisi null.

Contoh

Contoh berikut membuat Image objek kontrol server Web dan menggunakan ResolveUrl metode untuk mengatur jalur ke gambar, yang disimpan oleh ImageUrl properti .

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

Keterangan

relativeUrl Jika parameter berisi URL absolut, URL dikembalikan tidak berubah. relativeUrl Jika parameter berisi URL relatif, URL tersebut diubah ke URL relatif yang benar untuk jalur permintaan saat ini, sehingga browser dapat menyelesaikan URL.

Misalnya, pertimbangkan skenario berikut:

Klien telah meminta halaman ASP.NET yang berisi kontrol pengguna yang memiliki gambar yang terkait dengannya.
Halaman ASP.NET terletak di /Store/page1.aspx.
Kontrol pengguna terletak di /Store/UserControls/UC1.ascx.
File gambar terletak di /UserControls/Images/Image1.jpg.

Jika kontrol pengguna meneruskan jalur relatif ke gambar (yaitu, /Store/UserControls/Images/Image1.jpg) ke ResolveUrl metode , metode akan mengembalikan nilai /Images/Image1.jpg.

Metode ini menggunakan TemplateSourceDirectory properti untuk mengatasi URL absolut. URL yang dikembalikan adalah untuk penggunaan klien.

Untuk informasi selengkapnya tentang jalur sumber daya di situs Web, lihat ASP.NET Jalur Proyek Web.

Catatan

Hanya untuk halaman Web seluler, jika aplikasi Anda mengandalkan sesi tanpa cookie atau mungkin menerima permintaan dari browser seluler yang memerlukan sesi tanpa cookie, menggunakan tilde ("~") dalam jalur dapat mengakibatkan secara tidak sengaja membuat sesi baru dan berpotensi kehilangan data sesi. Untuk mengatur properti dengan jalur seperti "~/path", atasi jalur dengan memanggil ResolveUrl dengan argumen seperti "~/path" sebelum menetapkannya ke properti .

Berlaku untuk

Bagikan melalui