Sdílet prostřednictvím

HtmlSelect.DataSourceID Vlastnost

Definice

Obor názvů:
System.Web.UI.HtmlControls
Sestavení:
System.Web.dll

Získá nebo nastaví ID vlastnost ovládacího prvku zdroje dat, který HtmlSelect má ovládací prvek použít k načtení jeho zdroje dat.

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

Hodnota vlastnosti

String

Programový identifikátor přiřazený ke správě zdroje dat. Výchozí hodnota je prázdný řetězec (""), který označuje, že vlastnost nebyla nastavena.

Výjimky

HttpException

Zdroj dat nelze přeložit, protože je zadána hodnota pro DataSource vlastnost i DataSourceID vlastnost.

Příklady

Následující příklad kódu ukazuje použití DataSourceID vlastnosti k určení zdroje dat pro HtmlSelect ovládací prvek. Vlastnost DataSourceID je nastavena na ID vlastnost SqlDataSource ovládacího prvku použitého k načtení dat. Při načtení HtmlSelect stránky ovládací prvek automaticky vytvoří vazbu ke zdroji dat určenému SqlDataSource ovládacím prvku a data se zobrazí uživateli.

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

Poznámky

DataSourceID Tato vlastnost slouží k nastavení nebo přístupu k ID vlastnosti ovládacího prvku zdroje dat, který HtmlSelect má ovládací prvek použít k načtení zdroje dat. Ovládací prvek zdroje dat odkazovaný vlastností DataSourceID může být libovolný ovládací prvek, který implementuje IDataSource rozhraní. Ovládací prvek zdroje dat musí existovat buď ve stejném kontejneru pojmenování jako HtmlSelect ovládací prvek, který na něj odkazuje, nebo v nadřazené správě HtmlSelect ovládacího prvku. Když zadáte hodnotu pro tuto vlastnost, HtmlSelect ovládací prvek automaticky vytvoří vazbu na zadaný ovládací prvek zdroje dat. Nemusíte psát kód, který explicitně volá metodu DataBind .

Alternativně můžete pomocí DataSource vlastnosti určit zdroj hodnot, které se mají svázat s ovládacím HtmlSelect prvku. Zdrojem dat musí být kolekce, která implementuje System.Collections.IEnumerable rozhraní (například System.Data.DataView, System.Collections.ArrayListnebo ) nebo System.Collections.Generic.List<T>IListSource rozhraní. Při nastavování DataSource vlastnosti je nutné ručně napsat kód pro provedení datové vazby.

Pokud jsou pro vlastnost i DataSourceID vlastnost zadány DataSource hodnoty, ASP.NET nemůže přeložit zdroj dat a System.Web.HttpException vyvolá se výjimka.

Platí pro

Viz také