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.

ListControl الفئة

Visual Studio 2010

إلى يحصل فهرس .

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

[ControlValuePropertyAttribute("SelectedValue")]
public abstract class ListControl : DataBoundControl, 
	IEditableTextControl, ITextControl
<asp:ListControl />

فهرس من المعين ListControlداخل . Instead, this class is inherited by other classes, such as the CheckBoxList, DropDownList, ListBox, and RadioButtonList classes, to provide common basic functionality.

استخدم هذا الأسلوب إلى تحديد الفهرس المحدد ListControlفي . إذا كان محدد DataSourceهو غير موجود، يتم إرجاع فهرس-1. يوضح المثال التالي كيفية إلى استخدام DataMemberخاصية إلى عرض فهرس عمود للخلية المحددة. إرجاع على ListItem.Textتطبيق الكائن الذي يحتوي على الجميع ListItem.Valueالكائنات في DataTextField.DataValueField DataTextFormatString تنفيذ كائن التي تحتوي على الجميع كائن s داخل .

استخدم هذا الأسلوب إلى إنشاء Itemsمطبقة على الكائن الذي يمكن أن يكون iterated من خلال بسهولة إلى يحصل كل عنصر في . SelectedIndex يجب استدعاء الأسلوب بعد إنشاء تطبيق كائن أو بعد استخدام أسلوب لنقل العداد إلى عنصر أول في المجموعة. يوضح المثال التالي كيفية إلى استخدام SelectedItemأسلوب إلى إنشاء تطبيق الكائن.

The ListControl class provides the SelectedIndexChanged event, which is raised when the selection in the list control changes between posts to the server. لكافة الحالات. للحصول على مزيد من المعلومات حول معالجة الأحداث، راجع استهلاك الأحداث.

هذه خاصية دوماً بإرجاع ListControlللإشارة إلى أن IEditableTextControlيمكن كتابتها إلى في الجميع الحالات.

القيمة للإشارة إلى معرفة ما إذا كان بالوصول إلى ListBoxمزامنة (مؤشر ترابط-آمن). يحصل من في المحدد فهرس. القيمة فهرس ترتيبي يحدد إلى العائد.

ملاحظة الأمانملاحظة الأمان

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



<%@ 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> ListControl SelectedValue Example </title>
<script runat="server">

      void Button_Click(Object sender, EventArgs e)
      {

         // Perform this operation in a try-catch block in case the item is not found.
         try
         {
            List.SelectedValue = ItemTextBox.Text;
            MessageLabel.Text = "You selected " + List.SelectedValue + ".";
         }
         catch (Exception ex)
         {
            List.SelectedValue = null;
            MessageLabel.Text = "Item not found in ListBox control.";
         }

      }

   </script>

</head>

<body>

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

      <h3> ListControl SelectedValue Example </h3>

      <asp:ListBox ID="List"
           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:ListBox>

      <hr />

      Enter the value of the item to select: <br />
      <asp:TextBox ID="ItemTextBox"
           MaxLength="6"
           Text="Item 1"
           runat="server"/>

      &nbsp;&nbsp;

      <asp:Button ID="SelectButton"
           Text="Select Item"
           OnClick="Button_Click"
           runat="server"/>

      <br /><br />

      <asp:Label ID="MessageLabel"
           runat="server"/>     

   </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
إظهار: