방법: ASP.NET 구문을 사용하여 ASP.NET 웹 페이지에 서버 컨트롤 추가

업데이트: 2007년 11월

.aspx 파일에서 웹 서버 컨트롤을 직접 선언하여 페이지에 컨트롤을 추가할 수 있습니다.

참고:
ASP.NET 웹 페이지의 컨트롤에 대한 배경 정보를 보려면 ASP.NET 웹 서버 컨트롤 개요를 참조하십시오.

선언적으로 컨트롤을 추가하려면

1. 비주얼 디자이너를 사용 중인 경우 소스 편집 뷰로 전환합니다.

2. 컨트롤을 나타내는 요소를 .aspx 파일에 입력합니다. 사용할 정확한 구문은 추가하는 컨트롤에 따라 다르지만 일반적으로 다음 사항이 적용됩니다.

   • 컨트롤에 특성이 포함되어야 합니다.

   • 컨트롤이 복합 컨트롤의 일부가 아니고 반복되지 않는 경우(예: GridView, FormView, DetailsView, Repeater 또는 DataList 컨트롤)에는 컨트롤의 ID 특성을 설정합니다.

   • 웹 서버 컨트롤은 asp 네임스페이스를 참조하는 XML 태그로 선언됩니다.

   • 컨트롤 선언이 제대로 닫혀 있어야 합니다. 명시적으로 닫는 태그를 지정하거나, 컨트롤에 자식 요소가 없으면 자체적으로 닫는 태그를 지정할 수 있습니다. 단, 입력 컨트롤(예: HtmlInputText 서버 컨트롤 선언 구문, HtmlImage 서버 컨트롤 선언 구문, HtmlButton 서버 컨트롤 선언 구문)과 같이 자식 요소를 가질 수 없는 HTML 입력 컨트롤은 예외입니다.

   • 컨트롤 속성은 특성으로 선언됩니다.

     다음 예제에서는 웹 서버 컨트롤에 대한 일반적인 선언을 보여 줍니다.

     <!-- Textbox Web server control -->
     <asp:textbox id="TextBox1" runat="Server" Text=""></asp:textbox>
     
     <!-- Same, but with self-closing element -->
     <asp:textbox id="Textbox2" runat="Server" Text="" />
     
     <!-- Web DropDownList control, which contains subelements -->
     <asp:DropDownList id="DropDown1" >
        <asp:ListItem Value="0">0</asp:ListItem>
        <asp:ListItem Value="1">1</asp:ListItem>
        <asp:ListItem Value="2">2</asp:ListItem>
        <asp:ListItem Value="3">3</asp:ListItem>
     </asp:DropDownList>
     
     <asp:Repeater id="Repeater2" >
        <HeaderTemplate>
            Company data:
        </HeaderTemplate>
        <ItemTemplate>
            <asp:Label ID="Label1"  
                  Font-Names="verdana" Font-Size="10pt"
                  Text='<%# Eval("Name") %>' />
            ( <asp:Label ID="Label2" 
                  Font-Names="verdana" Font-Size="10pt"
                  Text='<%# Eval("Ticker") %>'/>
             )
        </ItemTemplate>
        <SeparatorTemplate>
            ,
        </SeparatorTemplate>
     </asp:Repeater>
     

     <!-- Textbox Web server control -->
     <asp:textbox id="TextBox1" runat="Server" Text=""></asp:textbox>
     
     <!-- Same, but with self-closing element -->
     <asp:textbox id="Textbox2" runat="Server" Text="" />
     
     <!-- Web DropDownList control, which contains subelements -->
     <asp:DropDownList id="DropDown1" >
        <asp:ListItem Value="0">0</asp:ListItem>
        <asp:ListItem Value="1">1</asp:ListItem>
        <asp:ListItem Value="2">2</asp:ListItem>
        <asp:ListItem Value="3">3</asp:ListItem>
     </asp:DropDownList>
     
     <asp:Repeater id="Repeater2" >
        <HeaderTemplate>
            Company data:
        </HeaderTemplate>
        <ItemTemplate>
            <asp:Label ID="Label1"  
                  Font-Names="verdana" Font-Size="10pt"
                  Text='<%# Eval("Name") %>' />
            ( <asp:Label ID="Label2" 
                  Font-Names="verdana" Font-Size="10pt"
                  Text='<%# Eval("Ticker") %>'/>
             )
        </ItemTemplate>
        <SeparatorTemplate>
            ,
        </SeparatorTemplate>
     </asp:Repeater>
     

     특정 웹 서버 컨트롤의 선언적 구문에 대한 내용은 웹 서버 컨트롤 구문을 참조하십시오.

     참고:
     페이지 디자이너에서 웹 서버 컨트롤을 제대로 렌더링할 수 없는 경우에는 "컨트롤 작성 오류"라는 텍스트와 함께 회색 상자가 나타납니다. 이는 대개 컨트롤의 ASP.NET 구문이 잘못되었음을 의미합니다. 예를 들어 웹 서버 컨트롤 요소에 특성이 없는 경우 이 오류가 발생합니다.

참고 항목

작업

방법: 프로그래밍 방식으로 ASP.NET 서버 컨트롤 스타일 속성 설정

방법: ASP.NET 구문을 사용하여 ASP.NET 서버 컨트롤 스타일 속성 설정

방법: 프로그래밍 방식으로 HTML 서버 컨트롤 속성 설정

개념

ASP.NET 웹 서버 컨트롤 개요