HtmlSelect.DataValueField プロパティとは? わかりやすく解説

Weblio 辞書 > コンピュータ > .NET Framework クラス ライブラリ リファレンス > HtmlSelect.DataValueField プロパティの意味・解説 

HtmlSelect.DataValueField プロパティ

HtmlSelect コントロールの各項目の ListItem.Value プロパティにバインドするデータ ソースのフィールドを取得または設定します。

名前空間: System.Web.UI.HtmlControls
アセンブリ: System.Web (system.web.dll 内)
構文構文

Public Overridable Property
 DataValueField As String
Dim instance As HtmlSelect
Dim value As String

value = instance.DataValueField

instance.DataValueField = value
public virtual string DataValueField { get;
 set; }
/** @property */
public String get_DataValueField ()

/** @property */
public void set_DataValueField (String value)
public function get DataValueField
 () : String

public function set DataValueField
 (value : String)

プロパティ値
HtmlSelect コントロールの各項目の ListItem.Value プロパティにバインドするデータ ソースのフィールド。既定値は空の文字列 ("") です。このプロパティが設定されていないことを示します。

解説解説

DataValueField プロパティを使用して、コントロールの各項目の ListItem.Value プロパティにデータ ソースのどのフィールドをバインドするかを指定します。このプロパティは通常、ListItem.Text プロパティの値とは異なる ListItem.Value プロパティの値を提供するために使用されます。

HtmlSelect クラスには、バインドするデータ ソースを指定するための 2 つのプロパティが用意されています。DataSource プロパティでは、IEnumerable インターフェイスまたは IListSource インターフェイスを実装するオブジェクト (DataView、ArrayList、Hashtable など) に HtmlSelect コントロールをバインドできます。DataSource プロパティを使用してデータ ソースを指定した場合、DataBind メソッドを明示的に呼び出して、コントロールとそのコントロールの DataValueField プロパティをデータ ソースにバインドする必要があります。

DataSourceID プロパティでは、データ ソースを表すデータ ソース コントロールに HtmlSelect コントロールをバインドできます。DataSourceID プロパティを使用してデータ ソースを指定した場合、HtmlSelect コントロールとそのコントロールの DataValueField プロパティがデータ ソース コントロールに自動的にバインドされます。したがって、DataBind メソッドを明示的に呼び出す必要はありません。

使用例使用例

DataSource プロパティと DataValueField プロパティを使用して、HtmlSelect コントロールの各項目の ListItem.Value プロパティにバインドするデータ ソースのフィールドを指定する方法を次のコード例に示します。

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

<html>

<head>

   <script runat="server">

      Sub Page_Load (sender As Object,
 e As EventArgs)
  
        ' Bind the HtmlSelect control to a data source when the page
 is initially loaded.
        If Not IsPostBack Then
        
           ' Open a connection to the database and run the query.
           ' Note that the connection string may vary depending on your
           ' database server settings.
           Dim ConnectString As String
 = "server=localhost;database=pubs;integrated security=SSPI"
           Dim QueryString As String
 = "select * from authors"

           Dim myConnection As SqlConnection
 = New SqlConnection(ConnectString)
           Dim myCommand As SqlDataAdapter
 = New SqlDataAdapter(QueryString, myConnection)

           ' Create a dataset to store the query results.
           Dim ds As DataSet = 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()
        
        End If

      End Sub

      Sub Button_Click (sender As Object,
 e As EventArgs)
        
         Dim i As Integer

         Label1.Text = "You selected:"

         For i = 0 To Select1.Items.Count -
 1
         
            If Select1.Items(i).Selected Then
               Label1.Text = Label1.Text & "<br> &nbsp;&nbsp;
 - " & Select1.Items(i).Text
            End If

         Next i

      End Sub

   </script>

</head>

<body>

   <form 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>
<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<%@ Import Namespace="System.Data.SqlClient" %>

<html>

<head>

   <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 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>
<%@ Page Language="JScript" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<%@ Import Namespace="System.Data.SqlClient" %>

<html>

<head>

   <script runat="server">

      function Page_Load (sender : Object, e : EventArgs) : void
      {

        // 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. 
           var ConnectString : String = "server=localhost;database=pubs;integrated
 security=SSPI";
           var QueryString : String = "select * from authors";

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

           // Create a dataset to store the query results.
           var ds : DataSet  = 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();
        }

      }

      function Button_Click (sender : Object, e : EventArgs) :
 void
      {
       
         // Display the selected items. 
         Label1.Text = "You selected:";

         for (var i: int=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 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 プロパティを使用して、HtmlSelect コントロールの各項目の ListItem.Value プロパティにバインドするデータ ソースのフィールドを指定する方法を次のコード例に示します。

<script runat="server" language="vb">
  
  Sub SubmitButton_Click(ByVal sender As
 Object, ByVal e As System.EventArgs)
    Dim i As Integer
    ' Iterate through the list items in the 
    ' HtmlSelect control to find the selected item.
    For i = 0 To Select1.Items.Count - 1
      If Select1.Items(i).Selected Then
        ' 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
      End If
    Next i
  
  End Sub
  
</script>

<html>
<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>
<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>
<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>
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
HtmlSelect クラス
HtmlSelect メンバ
System.Web.UI.HtmlControls 名前空間
HtmlSelect.DataSource プロパティ
ListItem.Value
HtmlSelect.DataTextField プロパティ
その他の技術情報
HTML サーバー コントロール



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「HtmlSelect.DataValueField プロパティ」の関連用語

HtmlSelect.DataValueField プロパティのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



HtmlSelect.DataValueField プロパティのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS