کنترل ASP.NET CheckBoxList
تعریف و استفاده
کنترل CheckBoxList برای ایجاد گروه‌های چک‌دسته چندگانه استفاده می‌شود.
هر گزینه‌ای در CheckBoxList کنترل توسط عنصر ListItem تعریف می‌شود!
توجه:این کنترل پشتیبانی از پیوندهای داده را دارد!
ویژگی‌ها
| ویژگی‌ها | توضیح | .NET |
|---|---|---|
| CellPadding | پیکسلی که بین لبه سلول جدول و محتوای آن قرار دارد. | 1.0 |
| CellSpacing | پیکسلی که بین سلول‌های جدول قرار دارد. | 1.0 |
| RepeatColumns | تعداد ستون‌هایی که در نمایش چک‌دسته‌های انتخابی استفاده می‌شوند. | 1.0 |
| RepeatDirection | تعیین می‌کند که چک‌دسته‌های انتخابی به صورت افقی یا عمودی تکرار شوند. | 1.0 |
| RepeatLayout | طرح چک‌دسته‌های انتخابی. | 1.0 |
| runat | این کنترل باید به عنوان کنترل سرور تنظیم شود. باید به "server" تنظیم شود. | 1.0 |
| TextAlign | متن در سمت چپ انتخاب‌های چک‌دسته ظاهر می‌شود. | 1.0 |
ListControl استاندارد ویژگی‌ها
AppendDataBoundItems, AutoPostBack, CausesValidation, DataTextField, DataTextFormatString, DataValueField, Items, runat, SelectedIndex, SelectedItem, SelectedValue, TagKey, Text, ValidationGroup, OnSelectedIndexChanged
کنترل ListControl شامل تمامی ویژگی‌های پایه‌ای کنترل‌های لیست است. کنترل‌هایی که از این کنترل ارث می‌برند شامل CheckBoxList, DropDownList, ListBox و RadioButtonList هستند.
برای توضیح کامل، لطفاً به ListControl استاندارد ویژگی‌ها.
ویژگی استاندارد کنترل وب
AccessKey, Attributes, BackColor, BorderColor, BorderStyle, BorderWidth, CssClass, Enabled, Font, EnableTheming, ForeColor, Height, IsEnabled, SkinID, Style, TabIndex, ToolTip, Width
برای توضیح کامل، لطفاً به ویژگی استاندارد کنترل وب.
ویژگی استاندارد کنترل
AppRelativeTemplateSourceDirectory, BindingContainer, ClientID, Controls, EnableTheming, EnableViewState, ID, NamingContainer, Page, Parent, Site, TemplateControl, TemplateSourceDirectory, UniqueID, Visible
برای توضیح کامل، لطفاً بهویژگی استاندارد کنترل.
مثال
- CheckBoxList
- در این مثال، ما یک کنترل CheckBoxList در فایل .aspx اعلام کرده‌ایم. سپس ما یک مدیریت رویداد برای رویداد SelectedIndexChanged ایجاد کرده‌ایم. این لیست انتخابی شش چک باکس دارد. هنگامی که کاربر یکی از آن‌ها را انتخاب می‌کند، صفحه به طور خودکار به سرور ارسال می‌شود و زیرپروژه Check اجرا می‌شود. این زیرپروژه مجموعه Items کنترل را جستجو می‌کند و ویژگی Selected هر یک از موارد را تست می‌کند. موارد انتخاب شده در کنترل Label نمایش داده می‌شوند.
