HtmlSelect.DataSourceID Tulajdonság

Definíció

Névtér:
System.Web.UI.HtmlControls
Szerelvény:
System.Web.dll

Lekéri vagy beállítja annak az ID adatforrás-vezérlőnek a tulajdonságát, amelyet a HtmlSelect vezérlőnek használnia kell az adatforrás lekéréséhez.

public:
 virtual property System::String ^ DataSourceID { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataSourceID { get; set; }
member this.DataSourceID : string with get, set
Public Overridable Property DataSourceID As String

Tulajdonság értéke

String

Az adatforrás-vezérlőhöz rendelt programozott azonosító. Az alapértelmezett érték egy üres sztring (""), amely azt jelzi, hogy a tulajdonság nincs beállítva.

Kivételek

HttpException

Az adatforrás nem oldható fel, mert a tulajdonsághoz és DataSource a DataSourceID tulajdonsághoz is meg van adva érték.

Példák

Az alábbi példakód bemutatja, hogyan használható a tulajdonság egy DataSourceID vezérlő adatforrásának megadására HtmlSelect . A DataSourceID tulajdonság az ID adatok lekéréséhez SqlDataSource használt vezérlő tulajdonságára van beállítva. A lap betöltésekor a HtmlSelect vezérlő automatikusan a vezérlő által SqlDataSource megadott adatforráshoz csatlakozik, és az adatok megjelennek a felhasználó számára.

<%@ page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>HtmlSelect.DataSourceID</title>
</head>
<body>
<form id="Form1" runat="server">
  <div>

    <h3> HtmlSelect.DataSourceID Example </h3>

    <p>Select an item from the list</p>

    <select id="Select1"
      name="Select1"
      datasourceid="SqlDataSource1"
      datatextfield="ProductName"
      runat="server">
    </select>

    <asp:sqldatasource id="SqlDataSource1"          
      connectionstring="workstation id=localhost;integrated security=SSPI;initial catalog=Northwind"
      selectcommand="SELECT * FROM [Products] Where ProductID <= 5"
      runat="server">
    </asp:sqldatasource>

  </div>
</form>
</body>
</html>

<%@ page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>HtmlSelect.DataSourceID</title>
</head>
<body>
<form id="Form1" runat="server">
  <div>

    <h3> HtmlSelect.DataSourceID Example </h3>

    <p>Select an item from the list</p>

    <select id="Select1"
      name="Select1"
      datasourceid="SqlDataSource1"
      datatextfield="ProductName"
      runat="server">
    </select>

    <asp:sqldatasource id="SqlDataSource1"          
      connectionstring="workstation id=localhost;integrated security=SSPI;initial catalog=Northwind"
      selectcommand="SELECT * FROM [Products] Where ProductID <= 5"
      runat="server">
    </asp:sqldatasource>

  </div>
</form>
</body>
</html>

Megjegyzések

DataSourceID A tulajdonság használatával beállíthatja vagy elérheti annak az ID adatforrás-vezérlőnek a tulajdonságát, amelyet a HtmlSelect vezérlőnek használnia kell az adatforrás lekéréséhez. A tulajdonság által DataSourceID hivatkozott adatforrás-vezérlő bármilyen vezérlő lehet, amely megvalósítja az interfészt IDataSource . Az adatforrás-vezérlőnek ugyanabban az elnevezési tárolóban kell lennie, mint az HtmlSelect arra hivatkozó vezérlőnek, vagy a HtmlSelect vezérlő szülővezérlőjében. Ha megad egy értéket ehhez a tulajdonsághoz, a HtmlSelect vezérlő automatikusan a megadott adatforrás-vezérlőhöz kapcsolódik. Nem kell olyan kódot írnia, amely kifejezetten meghívja a metódust DataBind .

Másik lehetőségként a DataSource tulajdonsággal megadhatja a vezérlőelemhez HtmlSelect kötéshez tartozó értékek forrását. Az adatforrásnak olyan gyűjteménynek kell lennie, amely implementálja az System.Collections.IEnumerable interfészt (például System.Data.DataView, System.Collections.ArrayListvagy ) vagy System.Collections.Generic.List<T>az interfészt IListSource . A tulajdonság beállításakor DataSource manuálisan kell írnia a kódot az adatkötés végrehajtásához.

Ha a DataSource tulajdonság és a DataSourceID tulajdonság értékei is meg vannak adva, ASP.NET nem tudja feloldani az adatforrást, és System.Web.HttpException kivételt eredményez.

A következőre érvényes:

Lásd még