방법: ASP.NET 웹 페이지에 사용자 정의 컨트롤 포함
업데이트: 2007년 11월
사용자 정의 컨트롤을 사용하려면 ASP.NET 웹 페이지에 사용자 정의 컨트롤을 포함해야 합니다. 사용자 정의 컨트롤이 포함된 페이지에 대한 요청을 받으면 이 사용자 정의 컨트롤은 ASP.NET 서버 컨트롤이 수행하는 모든 처리 단계를 그대로 수행합니다. 처리 단계에 대한 자세한 내용은 ASP.NET 페이지 수명 주기 개요를 참조하십시오.
Web Forms 페이지에 사용자 정의 컨트롤을 포함하려면
포함하는 ASP.NET 웹 페이지에서 다음과 같은 특성을 포함하는 @ Register 지시문을 만듭니다.
TagPrefix 특성 - 사용자 정의 컨트롤과 접두사를 연결합니다. 이 접두사는 사용자 정의 컨트롤 요소의 여는 태그에 포함됩니다.
TagName 특성 - 사용자 정의 컨트롤과 이름을 연결합니다. 이 이름은 사용자 정의 컨트롤 요소의 여는 태그에 포함됩니다.
Src 특성 - 포함할 사용자 정의 컨트롤 파일의 가상 경로를 정의합니다.
.gif "참고")
참고:Src 특성 값은 응용 프로그램의 루트 디렉터리에서 사용자 정의 컨트롤 소스 파일에 대한 상대 또는 절대 경로가 될 수 있습니다. 융통성을 위해 상대 경로를 사용하는 것이 좋습니다. 물결표(~) 문자는 응용 프로그램의 루트 디렉터리를 나타냅니다. 사용자 정의 컨트롤은 App_Code 디렉터리에 저장할 수 없습니다.
웹 페이지 본문의 form 요소에서 사용자 정의 컨트롤 요소를 선언합니다.
필요에 따라 사용자 정의 컨트롤이 공용 속성을 노출하는 경우 이러한 속성을 선언적으로 설정합니다.
예제
다음 예제에서는 사용자 정의 컨트롤이 포함된 ASP.NET 웹 페이지를 보여 줍니다. 사용자 정의 컨트롤은 Controls 폴더의 Spinner.ascx 파일에 있습니다. 이 페이지에서 컨트롤은 접두사 uc와 태그 이름 Spinner를 사용하도록 등록되었습니다. 사용자 정의 컨트롤 속성 MinValue와 MaxValue는 선언적으로 설정됩니다.
| 참고: |
|---|
이 예제에 사용되는 사용자 정의 컨트롤의 코드에 대한 자세한 내용은 방법: ASP.NET 사용자 정의 컨트롤 만들기를 참조하십시오. |
<%@ Page Language="VB" %>
<%@ Register TagPrefix="uc" TagName="Spinner"
Src="~\Controls\Spinner.ascx" %>
<html>
<body>
<form >
<uc:Spinner id="Spinner1"
MinValue="1"
MaxValue="10" />
</form>
</body>
<%@ Page Language="C#" %>
<%@ Register TagPrefix="uc" TagName="Spinner"
Src="~\Controls\Spinner.ascx" %>
<html>
<body>
<form >
<uc:Spinner id="Spinner1"
MinValue="1"
MaxValue="10" />
</form>
</body>