Repeater.DataSource 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 Datenquelle, die Daten zum Auffüllen der Liste bereitstellt.
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 ObjectEigenschaftswert
Ein IEnumerable Objekt IListSource , das eine Auflistung von Werten enthält, die zum Bereitstellen von Daten für dieses Steuerelement verwendet werden. Der Standardwert ist null.
- Attribute
Ausnahmen
Das DataSource angegebene Objekt ist keine unterstützte Datenquelle für das Repeater Steuerelement.
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 Beispiel wird veranschaulicht, wie das Repeater Steuerelement angegeben DataSource wird, wenn die Seite geladen wird.
<%@ 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>
Hinweise
Verwenden Sie diese Eigenschaft, um die Datenquelle anzugeben, die das Repeater Steuerelement auffüllt. Dies DataSource kann eine beliebige System.Collections.IEnumerable Auflistung sein, z. B. für System.Data.DataView den Zugriff auf Datenbanken, ein System.Collections.ArrayListArray oder ein IListSource Objekt. Wenn Sie die DataSource Eigenschaft festlegen, müssen Sie den Code manuell schreiben, um eine Bindung an die Datenquelle zu erstellen.
Wenn die durch die DataSource Eigenschaft angegebene Datenquelle mehrere Datenquellen enthält, verwenden Sie die DataMember Eigenschaft, um die spezifische Quelle anzugeben, die an das Steuerelement gebunden werden soll. Wenn Sie beispielsweise über mehrere System.Data.DataSet Tabellen verfügen, müssen Sie angeben, welche Tabelle an das Steuerelement gebunden werden soll. Nachdem Sie die Datenquelle angegeben haben, verwenden Sie die DataBind Methode, um die Datenquelle an das Steuerelement zu binden.
Alternativ können Sie die DataSourceID Eigenschaft verwenden, um automatisch eine Bindung an eine Datenquelle zu erstellen, die durch ein Datenquellensteuerelement dargestellt wird. Wenn Sie die DataSourceID Eigenschaft festlegen, wird das Repeater Steuerelement automatisch an das angegebene Datenquellensteuerelement gebunden. Sie müssen keinen Code schreiben, der die DataBind Methode explizit aufruft, es sei denn, Sie ändern die Eigenschaften des Repeater Steuerelements dynamisch.
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 wird System.Web.HttpException ausgelöst.
