BaseDataBoundControl.DataSourceID Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.dll

Získá nebo nastaví ID ovládacího prvku, ze kterého ovládací prvek vázané na data načte seznam datových položek.

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

Hodnota vlastnosti

String

ID ovládacího prvku, který představuje zdroj dat, ze kterého ovládací prvek svázaný s daty načítá svá data. Výchozí formát je Empty.

Atributy

ThemeableAttribute

Příklady

Následující příklad kódu ukazuje, jak DataSourceID se používá vlastnost ovládacího prvku vázaného na data. Ovládací GridView prvek je přidružen k ovládacímu SqlDataSource prvku nastavením jeho DataSourceID vlastnosti na "AuthorsSqlDataSource", ID SqlDataSource ovládacího prvku. Když je vlastnost nastavená DataSourceID (místo DataSource vlastnosti ), ovládací prvek vázané na data automaticky vytvoří vazbu na ovládací prvek zdroje dat za běhu.

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

Poznámky

Pokud byl ovládací prvek vázané na data již inicializován ( ConfirmInitState volá se metoda nebo OnPagePreLoad je zpracována událost), když nastavíte DataSourceID vlastnost , OnDataPropertyChanged zavolá se metoda , která vlastnost nastaví RequiresDataBinding na true.

Tuto vlastnost nelze nastavit pomocí motivů nebo šablon stylů. Další informace najdete v tématu ThemeableAttribute a ASP.NET Motivy a skiny.

Viz také

• DataSource