Repeater.DataSource 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 gegevensbron op die gegevens levert voor het vullen van de lijst.
public:
virtual property System::Object ^ DataSource { System::Object ^ get(); void set(System::Object ^ value); };[System.ComponentModel.Bindable(true)]
public virtual object DataSource { get; set; }[<System.ComponentModel.Bindable(true)>]
member this.DataSource : obj with get, setPublic Overridable Property DataSource As ObjectWaarde van eigenschap
Een IEnumerable of IListSource object dat een verzameling waarden bevat die worden gebruikt voor het leveren van gegevens aan dit besturingselement. De standaardwaarde is null.
- Kenmerken
Uitzonderingen
Het DataSource opgegeven object is geen ondersteunde gegevensbron voor het Repeater besturingselement.
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 voorbeeld ziet u hoe u het DataSourceRepeater besturingselement opgeeft wanneer de pagina wordt geladen.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!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>
<title>Repeater Example</title>
<script runat="server">
void Page_Load(Object Sender, EventArgs e) {
if (!IsPostBack) {
ArrayList values = new ArrayList();
values.Add("Apple");
values.Add("Orange");
values.Add("Pear");
values.Add("Banana");
values.Add("Grape");
// Set the DataSource of the Repeater.
Repeater1.DataSource = values;
Repeater1.DataBind();
}
}
</script>
</head>
<body>
<h3>Repeater Example</h3>
<form id="form1" runat="server">
<b>Repeater1:</b>
<br />
<asp:Repeater id="Repeater1" runat="server">
<HeaderTemplate>
<table border="1">
</HeaderTemplate>
<ItemTemplate>
<tr>
<td> <%# Container.DataItem %> </td>
</tr>
</ItemTemplate>
<FooterTemplate>
</table>
</FooterTemplate>
</asp:Repeater>
<br />
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!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>
<title>Repeater Example</title>
<script runat="server">
Sub Page_Load(Sender As Object, e As EventArgs)
If Not IsPostBack Then
Dim values As New ArrayList()
values.Add("Apple")
values.Add("Orange")
values.Add("Pear")
values.Add("Banana")
values.Add("Grape")
' Set the DataSource of the Repeater.
Repeater1.DataSource = values
Repeater1.DataBind()
End If
End Sub
</script>
</head>
<body>
<h3>Repeater Example</h3>
<form id="form1" runat="server">
<b>Repeater1:</b>
<br />
<asp:Repeater id="Repeater1" runat="server">
<HeaderTemplate>
<table border="1">
</HeaderTemplate>
<ItemTemplate>
<tr>
<td> <%# Container.DataItem %> </td>
</tr>
</ItemTemplate>
<FooterTemplate>
</table>
</FooterTemplate>
</asp:Repeater>
<br />
</form>
</body>
</html>
Opmerkingen
Gebruik deze eigenschap om de gegevensbron op te geven om het Repeater besturingselement te vullen. Dit DataSource kan elke System.Collections.IEnumerable verzameling zijn, zoals een System.Data.DataView voor toegang tot databases, een System.Collections.ArrayListof een matrix of een IListSource object. Wanneer u de DataSource eigenschap instelt, moet u de code handmatig schrijven om verbinding te maken met de gegevensbron.
Als de gegevensbron die is opgegeven door de DataSource eigenschap meerdere gegevensbronnen bevat, gebruikt u de DataMember eigenschap om de specifieke bron op te geven die aan het besturingselement moet worden gekoppeld. Als u bijvoorbeeld een System.Data.DataSet met meerdere tabellen hebt, moet u opgeven welke tabel aan het besturingselement moet worden gekoppeld. Nadat u de gegevensbron hebt opgegeven, gebruikt u de DataBind methode om de gegevensbron te binden aan het besturingselement.
U kunt de DataSourceID eigenschap ook gebruiken om automatisch verbinding te maken met een gegevensbron die wordt vertegenwoordigd door een gegevensbronbesturingselement. Wanneer u de DataSourceID eigenschap instelt, wordt het Repeater besturingselement automatisch gekoppeld aan het opgegeven gegevensbronbesturingselement. U hoeft geen code te schrijven die expliciet de DataBind methode aanroept, tenzij u dynamisch eigenschappen van het Repeater besturingselement wijzigt.
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 gegenereerd.