BaseDataBoundControl.DataSourceID Eigenschaft

Definition

Ruft die ID des Steuerelements ab, aus dem das datengebundene Steuerelement seine Liste mit Datenelementen abruft, oder legt diese fest.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

Eigenschaftswert

Die ID eines Steuerelements, die die Datenquelle darstellt, aus der das datengebundene Steuerelement seine Daten abruft.The ID of a control that represents the data source from which the data-bound control retrieves its data. Die Standardeinstellung ist Empty.The default is Empty.

Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, DataSourceID wie die-Eigenschaft eines Daten gebundenen Steuer Elements verwendet wird.The following code example demonstrates how the DataSourceID property of a data-bound control is used. Das GridView -Steuerelement wird dem SqlDataSource -Steuerelement zugeordnet DataSourceID , indem seine-Eigenschaft auf " SqlDataSource AuthorsSqlDataSource", die ID des Steuer Elements, festgelegt wird.The GridView control is associated to the SqlDataSource control by setting its DataSourceID property to "AuthorsSqlDataSource", the ID of the SqlDataSource control. Wenn die DataSourceID -Eigenschaft festgelegt wird (anstelle DataSource der-Eigenschaft), bindet das Daten gebundene Steuerelement zur Laufzeit automatisch an das Datenquellen-Steuerelement.When 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>

Hinweise

Wenn das Daten gebundene Steuerelement bereits ConfirmInitState initialisiert wurde (die-Methode wird aufgerufen, oder OnPagePreLoad das-Ereignis wird behandelt), DataSourceID Wenn Sie die OnDataPropertyChanged -Eigenschaft festlegen, wird die- RequiresDataBinding Methode aufgerufen, die die-Eigenschaft auf truefestlegt.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.

Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden.This property cannot be set by themes or style sheet themes. Weitere Informationen finden Sie unter ThemeableAttribute und ASP.NET-Designs und Skins.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Gilt für:

Siehe auch