BaseDataBoundControl.DataSourceID Eigenschap

Definitie

Naamruimte:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Hiermee haalt u de id op van het besturingselement waaruit het gegevensgebonden besturingselement de lijst met gegevensitems ophaalt.

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

Waarde van eigenschap

String

De id van een besturingselement dat de gegevensbron vertegenwoordigt waaruit het gegevensgebonden besturingselement de gegevens ophaalt. De standaardwaarde is Empty.

Kenmerken
ThemeableAttribute

Voorbeelden

In het volgende codevoorbeeld ziet u hoe de DataSourceID eigenschap van een gegevensgebonden besturingselement wordt gebruikt. Het GridView besturingselement is gekoppeld aan het SqlDataSource besturingselement door de eigenschap ervan in te stellen DataSourceID op 'AuthorsSqlDataSource', de id van het SqlDataSource besturingselement. Wanneer de DataSourceID eigenschap is ingesteld (in plaats van de DataSource eigenschap), wordt het gegevensgebonden besturingselement automatisch tijdens runtime gekoppeld aan het besturingselement voor de gegevensbron.

<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>

Opmerkingen

Als het gegevensgebonden besturingselement al is geïnitialiseerd (de ConfirmInitState methode wordt aangeroepen of OnPagePreLoad gebeurtenis wordt verwerkt) wanneer u de DataSourceID eigenschap instelt, wordt de OnDataPropertyChanged methode aangeroepen, waarmee de RequiresDataBinding eigenschap truewordt ingesteld op .

Deze eigenschap kan niet worden ingesteld op thema's of opmaakmodellen. Zie ThemeableAttribute en ASP.NET Thema's en skins voor meer informatie.

Van toepassing op

Zie ook