CheckBoxList 웹 서버 컨트롤 선언 구문

업데이트: 2007년 11월

다중 선택 확인란 그룹을 만드는 데 사용하는 컨트롤입니다. 이 컨트롤에서는 데이터 소스에 대한 바인딩을 지원합니다.

<asp:CheckBoxList
    AccessKey="string"
    AppendDataBoundItems="True|False"
    AutoPostBack="True|False"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CausesValidation="True|False"
    CellPadding="integer"
    CellSpacing="integer"
    CssClass="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    DataTextField="string"
    DataTextFormatString="string"
    DataValueField="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnTextChanged="TextChanged event handler"
    OnUnload="Unload event handler"
    RepeatColumns="integer"
    RepeatDirection="Horizontal|Vertical"
    RepeatLayout="Table|Flow"
    runat="server"
    SelectedIndex="integer"
    SelectedValue="string"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    TextAlign="Left|Right"
    ToolTip="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
>
            <asp:ListItem
                Enabled="True|False"
                Selected="True|False"
                Text="string"
                Value="string"
            />
</asp:CheckBoxList>

설명

CheckBoxList 컨트롤을 사용하면 데이터 바인딩을 사용하여 동적으로 생성할 수 있는 다중 선택 확인란 그룹을 만들 수 있습니다. CheckBoxList 컨트롤에 나타낼 항목을 지정하려면 각 항목에 대한 ListItem 요소를 CheckBoxList 컨트롤의 여는 태그와 닫는 태그 사이에 추가합니다.

CheckBoxList 컨트롤에서는 데이터 바인딩도 지원합니다. 컨트롤을 데이터 소스에 바인딩하려면 먼저 컨트롤에 표시할 항목이 포함된 데이터 소스(예: DataSourceControl 개체)를 만듭니다. 그런 다음 DataBind 메서드를 사용하여 데이터 소스를 CheckBoxList 컨트롤에 바인딩합니다. DataTextField 및 DataValueField 속성을 사용하면 컨트롤에 있는 각 목록 항목의 Text 속성과 Value 속성에 각각 바인딩할 데이터 소스 필드를 지정할 수 있습니다. 그러면 CheckBoxList 컨트롤에서는 데이터 소스에서 가져온 정보를 표시합니다.

CheckBoxList 컨트롤에서 선택된 항목을 확인하려면 Items 컬렉션을 반복하면서 컬렉션에 포함된 각 항목의 Selected 속성을 테스트합니다.

RepeatLayout 및 RepeatDirection 속성을 사용하면 목록이 표시되는 방법을 지정할 수 있습니다. RepeatLayout이 RepeatLayout.Table(기본 설정)로 설정되면 테이블 내에서 목록이 렌더링됩니다. 이 속성이 RepeatLayout.Flow로 설정되면 테이블 구조를 사용하지 않고 목록이 렌더링됩니다. 기본적으로 RepeatDirection는 RepeatDirection.Vertical로 설정됩니다. 이 속성을 RepeatDirection.Horizontal로 설정하면 목록이 가로로 렌더링됩니다.

CheckBoxList 웹 서버 컨트롤의 속성과 이벤트에 대한 자세한 내용은 CheckBoxList 클래스 설명서를 참조하십시오.

예제

다음은 .aspx 파일에서 CheckBoxList컨트롤을 선언하는 방법을 보여 주는 샘플입니다. 목록에는 동시에 선택할 수도 있는 여섯 개의 항목이 있습니다. 사용자가 확인란 중 하나를 선택할 때 페이지가 즉시 서버에 다시 게시되지는 않습니다. 페이지는 Button 클릭과 같은 다른 이벤트가 발생해야 게시됩니다. OnSelectedIndexChanged 이벤트에 대한 메서드를 선언하지 않았으므로 해당 이벤트 처리기가 호출되지 않습니다.

  <asp:CheckBoxList id="Check1"
       RepeatLayout="flow"
       runat="server">

  <asp:ListItem>Item 1</asp:ListItem>
  <asp:ListItem>Item 2</asp:ListItem>
  <asp:ListItem>Item 3</asp:ListItem>
  <asp:ListItem>Item 4</asp:ListItem>
  <asp:ListItem>Item 5</asp:ListItem>
  <asp:ListItem>Item 6</asp:ListItem>
</asp:CheckBoxList>

  <asp:CheckBoxList id="Check1"
       RepeatLayout="flow"
       runat="server">

  <asp:ListItem>Item 1</asp:ListItem>
  <asp:ListItem>Item 2</asp:ListItem>
  <asp:ListItem>Item 3</asp:ListItem>
  <asp:ListItem>Item 4</asp:ListItem>
  <asp:ListItem>Item 5</asp:ListItem>
  <asp:ListItem>Item 6</asp:ListItem>
</asp:CheckBoxList>

다음 예제에서는 CheckBoxList 컨트롤에서 선택한 확인란을 알 수 있는 방법을 보여 줍니다. 이 코드에서는 컨트롤의 Items 컬렉션을 반복하면서 각 항목의 Selected 속성을 테스트합니다. 그러면 선택된 항목이 Label 컨트롤에 표시됩니다.

Sub Button1_OnClick(ByVal sender As Object, ByVal e As EventArgs)
    Dim s As String
    Dim i As Integer
    s = "Selected items:<br />"
    For i = 0 To Check1.Items.Count - 1
        If Check1.Items(i).Selected Then
            s = s & Check1.Items(i).Text & "<br />"
        End If
    Next i
    Label1.Text = s
End Sub

void Button1_OnClick(Object sender, EventArgs e)
{
    string s;
    s = "Selected items:<br />";
    for (int i = 0; i < Check1.Items.Count; i++)
    {
        if (Check1.Items[i].Selected)
        {
            s = s + Check1.Items[i].Text + "<br />";
        }
    }
    Label1.Text = s;
}

참고 항목

참조

CheckBoxList

기타 리소스

웹 서버 컨트롤 구문