HtmlSelect.DataSourceID Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die ID-Eigenschaft des Datenquellensteuerelements ab, von dem das HtmlSelect-Steuerelement seine Datenquelle abrufen soll, oder legt diese fest.

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

Eigenschaftswert

String

Der programmgesteuerte Bezeichner, der dem Datenquellen-Steuerelement zugewiesen ist. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass diese Eigenschaft nicht festgelegt wurde.

Ausnahmen

HttpException

Die Datenquelle kann nicht aufgelöst werden, weil sowohl für die DataSource-Eigenschaft als auch für die DataSourceID-Eigenschaft ein Wert angegeben wurde.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die DataSourceID -Eigenschaft verwendet wird, um die Datenquelle für ein HtmlSelect Steuerelement anzugeben. Die DataSourceID -Eigenschaft wird auf die ID -Eigenschaft des Steuerelements festgelegt, das SqlDataSource zum Abrufen der Daten verwendet wird. Wenn die Seite geladen wird, wird das HtmlSelect Steuerelement automatisch an die vom SqlDataSource -Steuerelement angegebene Datenquelle gebunden, und die Daten werden dem Benutzer angezeigt.

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

Hinweise

Verwenden Sie die DataSourceID -Eigenschaft, um die ID Eigenschaft des Datenquellensteuerelements festzulegen oder darauf zuzugreifen, das das HtmlSelect Steuerelement zum Abrufen seiner Datenquelle verwenden soll. Das Datenquellensteuerelement, auf das von der DataSourceID -Eigenschaft verwiesen wird, kann ein beliebiges Steuerelement sein, das die IDataSource -Schnittstelle implementiert. Das Datenquellensteuerelement muss entweder im gleichen Namenscontainer wie das Steuerelement, das HtmlSelect darauf verweist, oder in einem übergeordneten Steuerelement des HtmlSelect Steuerelements vorhanden sein. Wenn Sie einen Wert für diese Eigenschaft angeben, wird das HtmlSelect Steuerelement automatisch an das angegebene Datenquellensteuerelement gebunden. Sie müssen keinen Code schreiben, der die DataBind -Methode explizit aufruft.

Alternativ können Sie die DataSource -Eigenschaft verwenden, um die Quelle der Werte anzugeben, die an ein HtmlSelect Steuerelement gebunden werden sollen. Die Datenquelle muss eine Auflistung sein, die die System.Collections.IEnumerable -Schnittstelle (z System.Data.DataView. B. , System.Collections.ArrayListoder System.Collections.Generic.List<T>) oder die IListSource -Schnittstelle implementiert. Wenn Sie die DataSource -Eigenschaft festlegen, müssen Sie den Code manuell schreiben, um die Datenbindung auszuführen.

Wenn Werte sowohl für die DataSource -Eigenschaft als auch für die DataSourceID -Eigenschaft angegeben werden, kann ASP.NET die Datenquelle nicht auflösen, und es wird eine System.Web.HttpException Ausnahme ausgelöst.

Gilt für:

Weitere Informationen

DataSource