HtmlSelect.DataSourceID Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.HtmlControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví ID vlastnost ovládacího prvku zdroje dat, který HtmlSelect by měl ovládací prvek použít k načtení 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ý ovládacímu prvku 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 vlastnost i DataSource DataSourceID vlastnost.

Příklady

Následující příklad kódu ukazuje, jak použít DataSourceID vlastnost k určení zdroje dat pro ovládací prvek HtmlSelect . Vlastnost DataSourceID je nastavena na ID vlastnost ovládacího prvku použitého SqlDataSource k načtení dat. Po načtení HtmlSelect stránky se ovládací prvek automaticky sváže se zdrojem dat určeným ovládacím SqlDataSource prvek 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 Vlastnost použijte k nastavení nebo přístupu k ID vlastnosti ovládacího prvku zdroje dat, který HtmlSelect by měl ovládací prvek použít k načtení zdroje dat. Ovládací prvek zdroje dat, na který DataSourceID vlastnost odkazuje, může být libovolný ovládací prvek, který implementuje IDataSource rozhraní. Ovládací prvek zdroje dat musí existovat buď ve stejném kontejneru názvů jako HtmlSelect ovládací prvek, který na něj odkazuje, nebo v nadřazené HtmlSelect ovládací prvek 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 .

Případně můžete vlastnost použít DataSource k určení zdroje 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 System.Collections.Generic.List<T>) nebo IListSource rozhraní. Při nastavování DataSource vlastnosti je nutné ručně napsat kód pro provedení datové vazby.

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

Platí pro

Viz také

DataSource

Sdílet prostřednictvím