This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

CheckBoxList الفئة

Visual Studio 2010

تحويل بين سلسلة الذي يحتوي على قائمة بأسماء الخطوط و صفيفة سلاسل تمثل الأسماء الفردية.

مساحة الاسم:  System.Web.UI.WebControls
التجميع:  System.Web (في System.Web.dll)

public class CheckBoxList : ListControl, 
	IRepeatInfoUser, INamingContainer, IPostBackDataHandler
<asp:CheckBoxList />

في هذا الموضوع:

مقدمة

كل اسم خط في السلسلة يجب أن تكون مفصولة بواسطة فاصلة.CheckBoxList السلسلة على سبيل المثال، "Arial، الأوقات verdana رومانية، الجديد"، تحول إلى صفيفة الذي يحتوي على سلاسل "Arial"، "مرة/مرات الروماني الجديد"، و "verdana".Items لاحظ أن تتم تمت إزالته الفواصل مع أي أبيض مسافة في بداية أو إنهاء اسم خط.Selected

ملاحظةملاحظة

المسافة البيضاء في منتصف اسم خط هو لا تتم تمت إزالته.CheckBox CheckBoxList أسلوب تنفيذ تشغيل العكسية.CheckBox

الحصول أو تعيين البيانات المصدر.

You can specify the way the list is displayed by using the RepeatLayout and RepeatDirection properties. استخدام RepeatLayoutخاصية إلى لتحديد عدد العناصر الموجودة في مصدر البيانات.

إذا كان الترحيل يستند إلى الخادم هو استخدام القيمة RepeatDirectionخاصية هو إرجاع; otherwهوe، العدد الإجمالي للعناصر الموجودة في مصدر بيانات هو التي يتم إرجاعها.RepeatDirection.Vertical على سبيل المثال، تحويل صفيفة يحتوي على سلاسل "Arial"، "مرة/مرات الروماني الجديد"، و "verdana" إلى السلسلة "Arial، الأوقات verdana رومانية، جديد".RepeatDirection.Horizontal RepeatLayout if الخادم-based ترحيل هو indicated بواسطة using the خاصية; otherwise, . لمزيد من المعلومات، انظر قائمة التعداد RepeatLayout.

استخدام أسلوب من هذه الفئة لتحويل سلسلة واحدة تحتوي على قائمة بأسماء الخطوط إلى صفيفة سلاسل التي تحتوي على أسماء فردية.

To specify items that you want to appear in the CheckBoxList control, place a ListItem element for each entry between the opening and closing tags of the CheckBoxList control.

يلي تعليمات برمجية مثال يوضح كيفية استخدام CheckBoxListطريقة لنسخ عناصر الموجودة في الكائن إلى صفيفة من الكائنات. مثيل DataSourceControlالذي يحتوي على للكائن عرض-لالولاية المعلومات. Next, use the DataBind method to bind the data source to the CheckBoxList control. Use the DataTextField and DataValueField properties to specify which field in the data source to bind to the Text and Value properties of each list item in the control, respectively. ثم يتم تمرير قيم كمتغير إلى HTML CheckBoxListعنصر إدخال عند معالجة الطلبات اللاحقة.

To determine the selected items in the CheckBoxList control, iterate through the Items collection and test the Selected property of each item in the collection.

ملاحظة تنبيهتنبيه

This عنصر تحكم can be used إلى عرض مستخدم إدخال, which might تضمين malicious العميل برنامج نصي. استخدم هذه construcإلىr إلى يهيّئ مثيل جديد فئة استخدام فهرس الصف المحدد. لمزيد من المعلومات، راجع تأمين عناصر التحكم القياسية ، كيفية: حماية من عمليات استغلال البرنامج النصي في تطبيق ويب من خلال تطبيق ترميز HTML إلى سلاسل ، و التحقق من صحة إدخالات المستخدم في صفحات ASP.NET على ويب.

‏إمكانية وصول ذوي الاحتياجات الخاصة

للحصول على المعلومات حول كيفية تكوين هذا عنصر تحكم حيث أنه يقوم بإنشاء ترميز التي تتوافق مع معايير إمكانية الوصول، راجع دعم الوصول في ASP.NETو عناصر تحكم ASP.NET و إمكانية التشغيل.

بناء جملة مصرحة

<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|OrderedList|UnorderedList"
    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

ملاحظةملاحظة

نموذج تعليمات برمجية التالي يستخدم طراز تعليمات برمجية أحادية و قد لا تعمل بشكل صحيح في حالة نسخ مباشرة في التعليمات برمجية-خلف ملف. يجب أن يتم نسخ نموذج تعليمات برمجية هذه في ملف نصي فارغ له ملحق.aspx. لمزيد من المعلومات حول نموذج تعليمات برمجية "نماذج ويب"، راجع طراز رمز صفحة ASP.NET على ويب.



<%@ Page Language="C#" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >

<head runat="server">
    <title> CheckBoxList Example </title>
<script runat="server">

      void Check_Clicked(Object sender, EventArgs e) 
      {

         Message.Text = "Selected Item(s):<br /><br />";

         // Iterate through the Items collection of the CheckBoxList 
         // control and display the selected items.
         for (int i=0; i<checkboxlist1.Items.Count; i++)
         {

            if (checkboxlist1.Items[i].Selected)
            {

               Message.Text += checkboxlist1.Items[i].Text + "<br />";

            }

         }

      }

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3> CheckBoxList Example </h3>

      Select items from the CheckBoxList.

      <br /><br />

      <asp:CheckBoxList id="checkboxlist1" 
           AutoPostBack="True"
           CellPadding="5"
           CellSpacing="5"
           RepeatColumns="2"
           RepeatDirection="Vertical"
           RepeatLayout="Flow"
           TextAlign="Right"
           OnSelectedIndexChanged="Check_Clicked"
           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>

      <br /><br />

      <asp:label id="Message" runat="server" AssociatedControlID="checkboxlist1"/>

   </form>

</body>

</html>



يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0, 1.1, 1.0
إظهار: