HtmlSelect.DataSourceID Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.HtmlControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia ID właściwość kontrolki źródła danych, która powinna być używana przez kontrolkę HtmlSelect do pobierania źródła danych.

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

Wartość właściwości

String

Identyfikator programowy przypisany do kontroli źródła danych. Wartość domyślna to pusty ciąg (""), który wskazuje, że właściwość nie została ustawiona.

Wyjątki

HttpException

Nie można rozpoznać źródła danych, ponieważ określono wartość zarówno dla właściwości, jak DataSource i DataSourceID właściwości.

Przykłady

W poniższym przykładzie kodu pokazano, jak za pomocą DataSourceID właściwości określić źródło danych dla kontrolki HtmlSelect . Właściwość DataSourceID jest ustawiana na ID właściwość kontrolki używanej SqlDataSource do pobierania danych. Po załadowaniu strony kontrolka HtmlSelect automatycznie wiąże się ze źródłem danych określonym przez kontrolkę SqlDataSource , a dane są wyświetlane użytkownikowi.

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

Uwagi

DataSourceID Użyj właściwości , aby ustawić lub uzyskać dostęp do ID właściwości kontrolki źródła danych, która powinna być używana przez kontrolkę HtmlSelect do pobierania źródła danych. Kontrolka źródła danych, do którego odwołuje się właściwość, może być dowolną DataSourceID kontrolką implementaną interfejsu IDataSource . Kontrolka źródła danych musi istnieć w tym samym kontenerze nazewnictwa co HtmlSelect kontrolka odwołująca się do niej lub w nadrzędnej kontrolce kontrolki HtmlSelect . Po określeniu wartości dla tej właściwości kontrolka HtmlSelect automatycznie wiąże się z określoną kontrolą źródła danych. Nie trzeba pisać kodu, który jawnie wywołuje metodę DataBind .

Alternatywnie możesz użyć DataSource właściwości , aby określić źródło wartości do powiązania z kontrolką HtmlSelect . Źródło danych musi być kolekcją, która implementuje System.Collections.IEnumerable interfejs (taki jak System.Data.DataView, System.Collections.ArrayListlub System.Collections.Generic.List<T>) lub IListSource interfejs. Po ustawieniu DataSource właściwości należy ręcznie napisać kod, aby wykonać powiązanie danych.

Jeśli wartości są określone zarówno DataSource dla właściwości, jak i DataSourceID właściwości, ASP.NET nie może rozpoznać źródła danych i System.Web.HttpException zgłaszany jest wyjątek.

Dotyczy

Zobacz też

DataSource

Udostępnij za pośrednictwem