HtmlSelect.DataSourceID Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de ID eigenschap op van het besturingselement voor de gegevensbron die door het besturingselement moet worden gebruikt om de HtmlSelect gegevensbron op te halen.
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 StringWaarde van eigenschap
De programmatische id die is toegewezen aan het besturingselement voor gegevensbronnen. De standaardwaarde is een lege tekenreeks (""), die aangeeft dat de eigenschap niet is ingesteld.
Uitzonderingen
De gegevensbron kan niet worden omgezet omdat er een waarde is opgegeven voor zowel de DataSource eigenschap als de DataSourceID eigenschap.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de DataSourceID eigenschap gebruikt om de gegevensbron voor een HtmlSelect besturingselement op te geven. De DataSourceID eigenschap is ingesteld op de ID eigenschap van het SqlDataSource besturingselement dat wordt gebruikt om de gegevens op te halen. Wanneer de pagina wordt geladen, wordt het HtmlSelect besturingselement automatisch gekoppeld aan de gegevensbron die is opgegeven door het SqlDataSource besturingselement en worden de gegevens weergegeven aan de gebruiker.
<%@ 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>
Opmerkingen
Gebruik de DataSourceID eigenschap om de ID eigenschap van het gegevensbronbesturingselement in te stellen of te openen die het besturingselement moet gebruiken om de HtmlSelect gegevensbron op te halen. Het besturingselement voor de gegevensbron waarnaar wordt verwezen door de DataSourceID eigenschap kan elk besturingselement zijn waarmee de IDataSource interface wordt geïmplementeerd. Het besturingselement voor de gegevensbron moet bestaan in dezelfde naamgevingscontainer als het HtmlSelect besturingselement dat ernaar verwijst of in een bovenliggend besturingselement van het HtmlSelect besturingselement. Wanneer u een waarde voor deze eigenschap opgeeft, wordt het HtmlSelect besturingselement automatisch gekoppeld aan het opgegeven gegevensbronbesturingselement. U hoeft geen code te schrijven waarmee de DataBind methode expliciet wordt aangeroepen.
U kunt de DataSource eigenschap ook gebruiken om de bron van waarden op te geven die aan een HtmlSelect besturingselement moeten worden gekoppeld. De gegevensbron moet een verzameling zijn waarmee de System.Collections.IEnumerable interface (zoals System.Data.DataView, System.Collections.ArrayListof System.Collections.Generic.List<T>) of de IListSource interface wordt geïmplementeerd. Wanneer u de DataSource eigenschap instelt, moet u de code handmatig schrijven om gegevensbinding uit te voeren.
Als waarden worden opgegeven voor zowel de eigenschap DataSource als de eigenschap DataSourceID, kan ASP.NET de gegevensbron niet oplossen en wordt er een System.Web.HttpException-uitzondering gegenereerd.