HtmlSelect.DataSource プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
HtmlSelect コントロールにバインドする情報のソースを取得または設定します。
public:
virtual property System::Object ^ DataSource { System::Object ^ get(); void set(System::Object ^ value); };public virtual object DataSource { get; set; }member this.DataSource : obj with get, setPublic Overridable Property DataSource As Objectプロパティ値
このコントロールにデータを提供するために使用する値のコレクションを格納している IEnumerable または IListSource。 既定値は null です。
例外
指定したデータ ソースが IEnumerable または IListSource と互換性がなく、null でもありません。
DataSource プロパティと DataSourceID プロパティの両方に値が指定されているため、データ ソースを解決できません。
例
次のコード例は、プロパティを使用 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 /> - " + 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>
<%@ Page Language="VB" 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">
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 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>
注釈
このプロパティを DataSource 使用して、コントロールにバインドするデータ ソースを HtmlSelect 指定します。 データ ソースは、インターフェイス (System.Collections.ArrayListSystem.Data.DataView、 など) またはSystem.Collections.Generic.List<T>インターフェイスをSystem.Collections.IEnumerable実装するIListSourceコレクションである必要があります。 プロパティを設定するときは、データ バインディングを DataSource 実行するコードを手動で記述する必要があります。
データ ソースに複数のテーブルを持つオブジェクトなど System.Data.DataSet 、複数のデータ セットが含まれている場合は、このプロパティを DataMember 使用して、コントロールにバインドするデータ セットを指定します。
コントロール内の各項目とListItem.ValueプロパティにバインドするListItem.Textデータ ソースのフィールドを指定するには、それぞれプロパティとDataValueFieldプロパティをDataTextField設定します。
または、このプロパティを DataSourceID 使用して、データ ソース コントロールによって表されるデータ ソースに自動的にバインドすることもできます。 プロパティを DataSourceID 設定すると、データ リスト コントロールは、指定したデータ ソース コントロールに自動的にバインドされます。 メソッドを明示的に呼び出すコードを記述する DataBind 必要はありません。
プロパティとDataSourceIDプロパティの両方に値がDataSource指定されている場合、ASP.NET はデータ ソースを解決できず、System.Web.HttpException例外がスローされます。