HtmlSelect.DataSourceID プロパティ

  • リファレンス

定義

名前空間:
System.Web.UI.HtmlControls
アセンブリ:
System.Web.dll

ID コントロールがデータ ソースの取得に使用する必要があるデータ ソース コントロールの HtmlSelect プロパティを取得または設定します。

public:
 virtual property System::String ^ DataSourceID { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataSourceID { get; set; }
member this.DataSourceID : string with get, set
Public Overridable Property DataSourceID As String

プロパティ値

String

データ ソース コントロールに割り当てられたプログラム ID。 既定値は空の文字列 ("") です。このプロパティが設定されていないことを示します。

例外

HttpException

DataSource プロパティと DataSourceID プロパティの両方に値が指定されているため、データ ソースを解決できません。

例

次のコード例では、 プロパティを使用 DataSourceID してコントロールのデータ ソースを指定する方法を HtmlSelect 示します。 プロパティは DataSourceID 、データの取得に ID 使用されるコントロールの SqlDataSource プロパティに設定されます。 ページが読み込まれると、 HtmlSelect コントロールはコントロールによって SqlDataSource 指定されたデータ ソースに自動的にバインドされ、データがユーザーに表示されます。

<%@ page language="C#" %>

<!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 id="Head1" runat="server">
    <title>HtmlSelect.DataSourceID</title>
</head>
<body>
<form id="Form1" runat="server">
  <div>

    <h3> HtmlSelect.DataSourceID Example </h3>

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

    <select id="Select1"
      name="Select1"
      datasourceid="SqlDataSource1"
      datatextfield="ProductName"
      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>

  </div>
</form>
</body>
</html>

<%@ page language="VB" %>

<!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 id="Head1" runat="server">
    <title>HtmlSelect.DataSourceID</title>
</head>
<body>
<form id="Form1" runat="server">
  <div>

    <h3> HtmlSelect.DataSourceID Example </h3>

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

    <select id="Select1"
      name="Select1"
      datasourceid="SqlDataSource1"
      datatextfield="ProductName"
      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>

  </div>
</form>
</body>
</html>

注釈

コントロールがデータ ソースを DataSourceID 取得するために使用する ID データ ソース コントロールの プロパティを HtmlSelect 設定またはアクセスするには、 プロパティを使用します。 プロパティによって DataSourceID 参照されるデータ ソース コントロールには、 インターフェイスを実装する任意のコントロールを IDataSource 指定できます。 データ ソース コントロールは、それを参照するコントロールと同じ名前付けコンテナー HtmlSelect 内、またはコントロールの親コントロール内に存在する HtmlSelect 必要があります。 このプロパティの値を指定すると、コントロールは HtmlSelect 指定したデータ ソース コントロールに自動的にバインドされます。 メソッドを明示的に呼び出すコードを記述する DataBind 必要はありません。

または、 プロパティを DataSource 使用して、コントロールにバインドする値のソースを HtmlSelect 指定することもできます。 データ ソースは、インターフェイス (、、または などSystem.Data.DataViewSystem.Collections.ArrayList) または System.Collections.Generic.List<T>インターフェイスをSystem.Collections.IEnumerable実装するIListSourceコレクションである必要があります。 プロパティを設定するときは、データ バインディングを DataSource 実行するコードを手動で記述する必要があります。

プロパティと DataSourceID プロパティの両方に値がDataSource指定されている場合、ASP.NET はデータ ソースを解決できず、System.Web.HttpException例外がスローされます。

適用対象

こちらもご覧ください