BaseDataBoundControl.DataSourceID 屬性

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.dll

取得或設定控制項的識別碼，資料繫結控制項會由此擷取其項目清單。

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

代表資料來源的控制項別碼，資料繫結控制項會由此擷取其資料。 預設為 Empty。

屬性

ThemeableAttribute

範例

下列程式碼範例示範如何使用 DataSourceID 資料繫結控制項的 屬性。 控制項 GridView 會藉由將 DataSourceID 控制項的 屬性設定為 「AuthorsSqlDataSource」， SqlDataSource 與控制項相關聯 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 主題和外觀。

另請參閱

• DataSource