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.DataValueField الخاصية

Visual Studio 2010

الحصول أو تعيين الحقل من مصدر بيانات ل يربط إلى ListItem.Valueخاصية لكل عنصر في HtmlSelectعنصر التحكم.

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

public virtual string DataValueField { get; set; }
<asp:HtmlSelect DataValueField="String" />

قيمة الخاصية

النوع: System.String
الحقل من مصدر بيانات ل يربط إلى ListItem.Valueخاصية لكل عنصر في HtmlSelectعنصر التحكم. القيمة افتراضية هو سلسلة فارغ ("")، التي تشير إلى أنه لم يتم تعيين خاصية.

استخدام DataValueFieldلتحديد حيث الحقول من مصدر بيانات للخاصية يربط إلى ListItem.Valueالخاصية لكل عنصر في عنصر التحكم. Th هو خاصية هو المستخدمة بشكل عام بتوفير قيمة ل ListItem.Valueخاصية التي تختلف عن القيمة ListItem.Textخاصية.

HtmlSelect توفر الفئة خاصيتين لتحديد مصدر بيانات إلى يربط إلى. DataSource خاصية تسمح لك ب يربط HtmlSelectعنصر التحكم إلى أي كائن بتنفيذ IEnumerableأو IListSourceواجهات (مثل DataView، ArrayList، أو Hashtable). عند استخدام DataSourceخاصية لتحديد مصدر بيانات، يجب استدعاء بشكل واضح DataBindالأسلوب يربط عنصر التحكم وبه DataValueFieldخاصية إلى مصدر بيانات.

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

مثال التعليمة البرمجية التالية يوضح كيفية استخدام DataSourceو DataValueFieldالخصائص لتحديد الحقول من مصدر بيانات ل يربط ListItem.Valueخاصية لكل عنصر في 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>


مثال التعليمة البرمجية التالية يوضح كيفية استخدام DataSourceIDو DataValueFieldالخصائص لتحديد الحقول من مصدر بيانات ل يربط ListItem.Valueخاصية لكل عنصر في HtmlSelectعنصر التحكم.


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server" language="C#">

  void SubmitButton_Click (object sender, System.EventArgs e)
  {
    // Iterate through the list items in the 
    // HtmlSelect control to find the selected item.
    for (int i = 0; i <= Select1.Items.Count - 1; i++)
    {
      if (Select1.Items[i].Selected)
        // Display the Value property of the selected item.
        // This property is populated by the DataValueField property.
        Label1.Text = "The Product ID is " + Select1.Items[i].Value;
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>HtmlSelect.DataValueField</title>
</head>
<body>
  <form id="Form1" runat="server">  

    <h3> HtmlSelect.DataValueField Example 2</h3>

    <p>Select an item from the list:</p>

    <select id="Select1"
      name="Select1"             
      datasourceid="SqlDataSource1"
      datatextfield="ProductName"
      datavaluefield="ProductID"
      runat="server">
    </select>

    <asp:sqldatasource id="SqlDataSource1"          
          connectionstring="workstation id=localhost;integrated security=SSPI;initial catalog=Northwind"
      selectcommand="SELECT * FROM [Products] Where ProductID <= 5"
      runat="server">
    </asp:sqldatasource>

    <asp:button id="SubmitButton"
      text="Submit"
      onclick="SubmitButton_Click"
      runat="Server">
    </asp:button>

    <br /><br />

    <asp:label id="Label1"
      runat="Server">
    </asp:label>

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