HtmlSelect.DataSourceID Eigenschaft
Definition
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.
Dient zum Abrufen oder Festlegen der ID Eigenschaft des Datenquellensteuerelements, das das HtmlSelect Steuerelement zum Abrufen der Datenquelle verwenden soll.
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, setPublic Overridable Property DataSourceID As StringEigenschaftswert
Der programmgesteuerte Bezeichner, der dem Datenquellensteuerelement zugewiesen ist. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass die Eigenschaft nicht festgelegt wurde.
Ausnahmen
Die Datenquelle kann nicht aufgelöst werden, da ein Wert sowohl für die DataSource Eigenschaft als auch für die DataSourceID Eigenschaft angegeben wird.
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 SqlDataSource Steuerelements festgelegt, das zum Abrufen der Daten verwendet wird. Wenn die Seite geladen wird, wird das HtmlSelect Steuerelement automatisch an die durch das 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 der Datenquelle verwenden soll. Das datenquellenbasierte Steuerelement, auf das von der DataSourceID Eigenschaft verwiesen wird, kann ein beliebiges Steuerelement sein, das die IDataSource Schnittstelle implementiert. Das Datenquellensteuerelement muss entweder im gleichen Benennungscontainer wie das HtmlSelect Steuerelement vorhanden sein, das darauf verweist, oder in einem übergeordneten Steuerelement des HtmlSelect Steuerelements. 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 von Werten anzugeben, die an ein HtmlSelect Steuerelement gebunden werden sollen. Die Datenquelle muss eine Sammlung sein, die die System.Collections.IEnumerable Schnittstelle (z System.Data.DataView. B. , System.Collections.ArrayList, oder 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 eine System.Web.HttpException Ausnahme ausgelöst wird.
