BaseDataList.DataSourceID プロパティ

.NET Framework クラス ライブラリ リファレンス

BaseDataList.DataSourceID プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

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

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

Visual Basic (宣言)

<ThemeableAttribute(False)> _
Public Overridable Property
 DataSourceID As String

Visual Basic (使用法)

Dim instance As BaseDataList
Dim value As String

value = instance.DataSourceID

instance.DataSourceID = value

C#

[ThemeableAttribute(false)] 
public virtual string DataSourceID { get;
 set; }

C++

[ThemeableAttribute(false)] 
public:
virtual property String^ DataSourceID {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_DataSourceID ()

/** @property */
public void set_DataSourceID (String value)

JScript

public function get DataSourceID
 () : String

public function set DataSourceID
 (value : String)

プロパティ値
データ ソース コントロールに割り当てられたプログラム ID。

例外

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

解説

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

また、DataSource プロパティを使用して、データ リスト コントロールにバインドする値のソースを指定できます。このデータ ソースは、BaseDataList クラスから派生したコントロールにバインドする System.Collections.IEnumerable インターフェイス (System.Data.DataView、System.Collections.ArrayList、System.Collections.Hashtable など)、または IListSource インターフェイスを実装するオブジェクトである必要があります。DataSource プロパティを設定する場合は、データ バインディングを実行するコードを手動で記述する必要があります。

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

このプロパティを、テーマまたはスタイル シート テーマを使用して設定することはできません。詳細については、ThemeableAttribute、ASP.NET のテーマとスキンの概要 の各トピックを参照してください。

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
BaseDataList クラス
BaseDataList メンバ
System.Web.UI.WebControls 名前空間
BaseDataList.DataSource プロパティ