Language

BaseDataBoundControl.DataSourceID プロパティ

定義

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

データ バインド コントロールがデータ項目のリストを取得する元のコントロールの ID を取得または設定します。

public:
 virtual property System::String ^ DataSourceID { System::String ^ get(); void set(System::String ^ value); };
[System.Web.UI.Themeable(false)]
public virtual string DataSourceID { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.DataSourceID : string with get, set
Public Overridable Property DataSourceID As String

プロパティ値

String

データ バインド コントロールがデータを取得するデータ ソースを表すコントロールの ID。 既定値は Empty です。

属性
ThemeableAttribute

例

次のコード例は、データ バインド コントロールの DataSourceID プロパティの使用方法を示しています。 GridView コントロールは、SqlDataSource プロパティを DataSourceID コントロールの ID である "AuthorsSqlDataSource" に設定することで、SqlDataSource コントロールに関連付けられます。 DataSourceID プロパティが (DataSource プロパティではなく) 設定されている場合、データ バインド コントロールは実行時にデータ ソース コントロールに自動的にバインドされます。

<asp:sqldatasource id="CustomersSource"
  selectcommand="SELECT CustomerID, CompanyName, FirstName, LastName FROM SalesLT.Customer"
  connectionstring="<%$ ConnectionStrings:AWLTConnectionString %>" 
  runat="server"/>

<asp:gridview id="CustomersGridView" 
  datasourceid="CustomersSource" 
  autogeneratecolumns="False"
  emptydatatext="No data available." 
  allowpaging="True" 
  runat="server" DataKeyNames="CustomerID">
    <Columns>
        <asp:BoundField DataField="CustomerID" HeaderText="CustomerID" 
            InsertVisible="False" ReadOnly="True" SortExpression="CustomerID" />
        <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" 
            SortExpression="CompanyName" />
        <asp:BoundField DataField="FirstName" HeaderText="FirstName" 
            SortExpression="FirstName" />
        <asp:BoundField DataField="LastName" HeaderText="LastName" 
            SortExpression="LastName" />
    </Columns>
</asp:gridview>

<asp:sqldatasource id="CustomersSource"
  selectcommand="SELECT CustomerID, CompanyName, FirstName, LastName FROM SalesLT.Customer"
  connectionstring="<%$ ConnectionStrings:AWLTConnectionString %>" 
  runat="server"/>

<asp:gridview id="CustomersGridView" 
  datasourceid="CustomersSource" 
  autogeneratecolumns="False"
  emptydatatext="No data available." 
  allowpaging="True" 
  runat="server" DataKeyNames="CustomerID">
    <Columns>
        <asp:BoundField DataField="CustomerID" HeaderText="CustomerID" 
            InsertVisible="False" ReadOnly="True" SortExpression="CustomerID" />
        <asp:BoundField DataField="CompanyName" HeaderText="CompanyName" 
            SortExpression="CompanyName" />
        <asp:BoundField DataField="FirstName" HeaderText="FirstName" 
            SortExpression="FirstName" />
        <asp:BoundField DataField="LastName" HeaderText="LastName" 
            SortExpression="LastName" />
    </Columns>
</asp:gridview>

注釈

ConfirmInitState プロパティを設定するときに、データ バインド コントロールが既に初期化されている場合 (OnPagePreLoad メソッドが呼び出されるか、イベントが処理DataSourceID)、OnDataPropertyChanged メソッドが呼び出され、RequiresDataBinding プロパティがtrueに設定されます。

このプロパティは、テーマまたはスタイル シートのテーマでは設定できません。 詳細については、「テーマとスキンの ThemeableAttribute と ASP.NET」を参照してください。

適用対象

こちらもご覧ください