Control.ResolveUrl(String) 메서드

정의

URL을 요청 클라이언트에서 사용할 수 있는 URL로 변환합니다.Converts a URL into one that is usable on the requesting client.

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

매개 변수

relativeUrl
String

TemplateSourceDirectory 속성과 관련된 URL입니다.The URL associated with the TemplateSourceDirectory property.

반환

변환된 URL입니다.The converted URL.

예외

relativeUrl 매개 변수에 null이 들어 있으면 발생하는 경우Occurs if the relativeUrl parameter contains null.

예제

다음 예제에서는 Image 웹 서버 컨트롤 개체를 만들고 ResolveUrl 메서드를 사용 하 여 ImageUrl 속성에 의해 저장 되는 이미지에 대 한 경로를 설정 합니다.The following example creates an Image Web server control object and uses the ResolveUrl method to set the path to the image, which is stored by the ImageUrl property.

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

설명

relativeUrl 매개 변수에 절대 URL이 포함 된 경우에는 URL이 변경 되지 않고 반환 됩니다.If the relativeUrl parameter contains an absolute URL, the URL is returned unchanged. relativeUrl 매개 변수에 상대 URL이 포함 되어 있으면 브라우저에서 URL을 확인할 수 있도록 해당 URL이 현재 요청 경로에 맞는 상대 URL로 변경 됩니다.If the relativeUrl parameter contains a relative URL, that URL is changed to a relative URL that is correct for the current request path, so that the browser can resolve the URL.

예를 들어 다음 시나리오를 고려할 수 있습니다.For example, consider the following scenario:

  • 클라이언트가 연결 된 이미지를 포함 하는 사용자 정의 컨트롤을 포함 하는 ASP.NET 페이지를 요청 했습니다.A client has requested an ASP.NET page that contains a user control that has an image associated with it.

  • ASP.NET 페이지는/Sv\page\page-xs에 있습니다.The ASP.NET page is located at /Store/page1.aspx.

  • 사용자 정의 컨트롤은/Store/UserControls/UC1.ascx.에 있습니다.The user control is located at /Store/UserControls/UC1.ascx.

  • 이미지 파일은/UserControls/Images/Image1.jpg.에 있습니다.The image file is located at /UserControls/Images/Image1.jpg.

사용자 정의 컨트롤에서 이미지에 대 한 상대 경로 (즉,/Store/UserControls/Images/Image1.jpg)를 ResolveUrl 메서드에 전달 하는 경우 메서드는/Images/image1.jpg) 값을 반환 합니다.If the user control passes the relative path to the image (that is, /Store/UserControls/Images/Image1.jpg) to the ResolveUrl method, the method will return the value /Images/Image1.jpg.

이 메서드는 TemplateSourceDirectory 속성을 사용 하 여 절대 URL로 확인 합니다.This method uses the TemplateSourceDirectory property to resolve to the absolute URL. 반환 된 URL은 클라이언트에서 사용 하기 위한 것입니다.The returned URL is for client use.

웹 사이트의 리소스 경로에 대 한 자세한 내용은 ASP.NET 웹 프로젝트 경로를 참조 하세요.For more information on resource paths in a Web site, see ASP.NET Web Project Paths.

참고

모바일 웹 페이지와 애플리케이션이 쿠키 없는 세션에 의존 하거나 쿠키 없는 세션을 필요로 하는 모바일 브라우저에서 요청을 받을 수, 하는 경우 사용 하 여 물결표 ("~") 경로 새 세션을 만드는 실수로 발생할 수 있습니다 및 세션 데이터를 잠재적으로 손실 됩니다.For mobile Web pages only, if your application relies on cookieless sessions or might receive requests from mobile browsers that require cookieless sessions, using a tilde ("~") in a path can result in inadvertently creating a new session and potentially losing session data. "~/path" 와 같은 경로를 사용 하 여 속성을 설정 하려면 속성에 할당 하기 전에 "~/경로" 와 같은 인수를 사용 하 여 ResolveUrl를 호출 하 여 경로를 확인 합니다.To set a property with a path such as "~/path", resolve the path by calling the ResolveUrl with an argument such as "~/path" before assigning it to the property.

적용 대상

추가 정보