BaseDataBoundControl.DataSourceID プロパティ

定義

データ バインド コントロールのデータ項目一覧の取得元となるコントロールの ID を取得または設定します。Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.

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; }
member this.DataSourceID : string with get, set
Public Overridable Property DataSourceID As String

プロパティ値

データ バインド コントロールによるデータの取得元となるデータ ソースを表すコントロールの ID。The ID of a control that represents the data source from which the data-bound control retrieves its data. 既定値は、Empty です。The default is Empty.

属性

次のコード例は、データDataSourceIDバインドコントロールのプロパティを使用する方法を示しています。The following code example demonstrates how the DataSourceID property of a data-bound control is used. コントロールはDataSourceID 、プロパティをSqlDataSourceコントロールSqlDataSourceの ID である "authorssqldatasource" に設定することによって、コントロールに関連付けられます。 GridViewThe GridView control is associated to the SqlDataSource control by setting its DataSourceID property to "AuthorsSqlDataSource", the ID of the SqlDataSource control. (プロパティではなく) プロパティが設定されている場合、データバインドコントロールは実行時にデータソースコントロールに自動的にバインドされます。 DataSourceID DataSourceWhen the DataSourceID property is set (instead of the DataSource property), the data-bound control automatically binds to the data source control at run time.

<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設定されます。If the data-bound control has already been initialized (the ConfirmInitState method is called or OnPagePreLoad event is handled) when you set the DataSourceID property, the OnDataPropertyChanged method is called, which sets the RequiresDataBinding property to true.

このプロパティは、テーマまたはスタイル シート テーマによって設定することはできません。This property cannot be set by themes or style sheet themes. 詳細についてはThemeableAttribute 、「」および「 ASP.NET theme and スキン」を参照してください。For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

適用対象

こちらもご覧ください