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.

HtmlSelect.DataSource الخاصية

Visual Studio 2010

الحصول أو مصدر معلومات لتعيين يربط إلى HtmlSelectعنصر التحكم.

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

public virtual Object DataSource { get; set; }
<asp:HtmlSelect DataSource="Object" />

قيمة الخاصية

النوع: System.Object
IEnumerable أو IListSourceالذي يحتوي على مجموعة من قيم المستخدمة لتوفير بيانات لهذا عنصر تحكم. القيمة الافتراضية هي null.

استثناء:شرط
ArgumentException

مصدر بيانات المحدد هو غير متوافق مع أي System.Collections.IEnumerableأو System.ComponentModel.IListSource، وهو هو لا null.

HttpException

بيانات المصدر يتعذر حلها بسبب عدم تحديد القيمة لكلا DataSourceخاصية و DataSourceIDخاصية.

استخدام DataSourceبتحديد مصدر بيانات للخاصية يربط إلى HtmlSelectعنصر التحكم. يجب أن يكون مصدر بيانات أحد الكائنات التي تقوم بتنفيذ أي من System.Collections.IEnumerableواجهة (مثل كـ System.Data.DataView، System.Collections.ArrayList، أو System.Collections.Hashtable) أو IListSourceالواجهة. عند تعيين DataSourceخاصية، يجب يدوياً كتابة تعليمات برمجية إلى إجراء ربط بيانات.

إذا كان مصدر بيانات يحتوي على مجموعات متعددة من بيانات، مثل System.Data.DataSetالكائن بجداول متعددة، استخدم DataMemberخاصية لتحديد أي التعيين بيانات إلى يربط إلى عنصر التحكم.

يمكنك تحديد حقول من مصدر بيانات لربط ListItem.Textو ListItem.Valueخصائص كل عنصر في عنصر التحكم بتعيين DataTextFieldو DataValueFieldالخصائص، على التوالي.

بدلاً من ذلك، يمكنك استخدام DataSourceIDالخاصية تلقائياً يربط يمثله بيانات بمصدر بيانات مصدر عنصر التحكم. عند تعيين DataSourceIDخاصية، بيانات قائمة عنصر التحكم auإلىmatically الروابط إلى مصدر بيانات المحدد عنصر تحكم. لا تحتاج إلى كتابة تعليمات برمجية التي تستدعي بوضوح DataBindأسلوب.

إذا تم تحديد قيم لكل من DataSourceخاصية و DataSourceIDخاصية، ASP.NET هو لا غير قادرة على حل مصدر بيانات و System.Web.HttpExceptionاستثناء هو طرح.

يوضح المثال تعليمات برمجية التالي كيفية استخدام DataSourceخاصية لتحديد مصدر معلومات ل يربط إلى HtmlSelectعنصر التحكم.


<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<%@ Import Namespace="System.Data.SqlClient" %>

<!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>
    <title> HtmlSelect Example </title>
<script runat="server">

      void Page_Load (Object sender, EventArgs e)
      {

        // Bind the HtmlSelect control to a data source when the page is initially loaded.
        if (!IsPostBack)
        {

           // Open a connection to the database and run the query.
           // Note that the connection string may vary depending on your
           // database server settings. 
           string ConnectString = "server=localhost;database=pubs;integrated security=SSPI";
           string QueryString = "select * from authors";

           SqlConnection myConnection = new SqlConnection(ConnectString);
           SqlDataAdapter myCommand = new SqlDataAdapter(QueryString, myConnection);

           // Create a dataset to store the query results.
           DataSet ds = new DataSet();
           myCommand.Fill(ds, "Authors");

           // Bind the HtmlSelect control to the data source.
           Select1.DataSource = ds;
           Select1.DataTextField = "au_fname";
           Select1.DataValueField = "au_fname";
           Select1.DataBind();
        }

      }

      void Button_Click (Object sender, EventArgs e)
      {

         // Display the selected items. 
         Label1.Text = "You selected:";

         for (int i=0; i<=Select1.Items.Count - 1; i++)
         {
            if (Select1.Items[i].Selected)
               Label1.Text += "<br /> &nbsp;&nbsp; - " + Select1.Items[i].Text;
         }

      }

   </script>

</head>

<body>

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

      <h3> HtmlSelect Example </h3>

      Select items from the list. <br />
      Use the Control or Shift key to select multiple items. <br /><br />

      <select id="Select1"
              multiple="true" 
              runat="server"/>

      <br /><br />

      <button id="Button1"
              onserverclick="Button_Click"
              runat="server">

         Submit

      </button>

      <br /><br />

      <asp:Label id="Label1"
           runat="server"/>

   </form>

</body>

</html>


نظام التشغيل 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
إظهار: