HtmlSelect.DataValueField-Eigenschaft
Ruft das Feld aus der Datenquelle ab, das an die ListItem.Value-Eigenschaft der einzelnen Elemente im HtmlSelect-Steuerelement gebunden werden soll, oder legt dieses fest.
Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Overridable Property DataValueField As String
'Usage
Dim instance As HtmlSelect
Dim value As String
value = instance.DataValueField
instance.DataValueField = value
public virtual string DataValueField { get; set; }
public:
virtual property String^ DataValueField {
String^ get ();
void set (String^ value);
}
/** @property */
public String get_DataValueField ()
/** @property */
public void set_DataValueField (String value)
public function get DataValueField () : String
public function set DataValueField (value : String)
Eigenschaftenwert
Das Feld aus der Datenquelle, das an die ListItem.Value-Eigenschaft der einzelnen Elemente im HtmlSelect-Steuerelement gebunden werden soll. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass diese Eigenschaft nicht festgelegt wurde.
Hinweise
Geben Sie mit der DataValueField-Eigenschaft an, welches Feld aus der Datenquelle an die ListItem.Value-Eigenschaft der einzelnen Elemente im Steuerelement gebunden werden soll. Diese Eigenschaft wird häufig zum Bereitstellen eines Werts für die ListItem.Value-Eigenschaft verwendet, der sich vom Wert der ListItem.Text-Eigenschaft unterscheidet.
Die HtmlSelect-Klasse stellt zwei Eigenschaften für das Angeben der zu bindenden Datenquelle bereit. Die DataSource-Eigenschaft ermöglicht das Binden eines HtmlSelect-Steuerelements an ein beliebiges Objekt, das die IEnumerable-Schnittstelle oder die IListSource-Schnittstelle implementiert (z. B. DataView, ArrayList oder Hashtable). Wenn Sie die Datenquelle mit der DataSource-Eigenschaft angeben, müssen Sie die DataBind-Methode explizit aufrufen, um das Steuerelement und seine DataValueField-Eigenschaft an die Datenquelle zu binden.
Die DataSourceID-Eigenschaft ermöglicht das Binden eines HtmlSelect-Steuerelements an ein Datenquellensteuerelement, das eine Datenquelle darstellt. Wenn Sie die Datenquelle mit der DataSourceID-Eigenschaft angeben, werden das HtmlSelect-Steuerelement und seine DataValueField-Eigenschaft automatisch an das Datenquellensteuerelement gebunden. Daher müssen Sie die DataBind-Methode nicht explizit aufrufen.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie mit der DataSource-Eigenschaft und der DataValueField-Eigenschaft das Feld der Datenquelle angegeben wird, das an die ListItem.Value-Eigenschaft der einzelnen Elemente im HtmlSelect-Steuerelement gebunden werden soll.
<%@ 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> - " & 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> - " + 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> - " + 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>
Im folgenden Codebeispiel wird veranschaulicht, wie mit der DataSourceID-Eigenschaft und der DataValueField-Eigenschaft das Feld der Datenquelle angegeben wird, das an die ListItem.Value-Eigenschaft der einzelnen Elemente im HtmlSelect-Steuerelement gebunden werden soll.
<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>
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
HtmlSelect-Klasse
HtmlSelect-Member
System.Web.UI.HtmlControls-Namespace
HtmlSelect.DataSource-Eigenschaft
ListItem.Value
HtmlSelect.DataTextField-Eigenschaft