Repeater.DataSource-Eigenschaft
Ruft die Datenquelle ab, die Daten für das Auffüllen der Liste bereitstellt, oder legt diese fest.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
<BindableAttribute(True)> _
Public Overridable Property DataSource As Object
'Usage
Dim instance As Repeater
Dim value As Object
value = instance.DataSource
instance.DataSource = value
[BindableAttribute(true)]
public virtual Object DataSource { get; set; }
[BindableAttribute(true)]
public:
virtual property Object^ DataSource {
Object^ get ();
void set (Object^ value);
}
/** @property */
public Object get_DataSource ()
/** @property */
public void set_DataSource (Object value)
public function get DataSource () : Object
public function set DataSource (value : Object)
Eigenschaftenwert
Ein IEnumerable-Objekt oder ein IListSource-Objekt, das eine Werteauflistung zum Bereitstellen von Daten für dieses Steuerelement enthält. Der Standardwert ist NULL (Nothing in Visual Basic).
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
Das angegebene DataSource-Objekt ist keine unterstützte Datenquelle für das Repeater-Steuerelement. |
|
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. |
Hinweise
Mit dieser Eigenschaft können Sie die Datenquelle angeben, die zum Auffüllen des Repeater-Steuerelements verwendet wird. Die DataSource kann jedes System.Collections.IEnumerable-Objekt sein, z. B. eine System.Data.DataView für den Zugriff auf Datenbanken, eine System.Collections.ArrayList, eine System.Collections.Hashtable oder ein Array bzw. ein IListSource-Objekt. Wenn Sie die DataSource-Eigenschaft festlegen, müssen Sie den Code zum Binden an die Datenquelle manuell schreiben.
Wenn die von der DataSource-Eigenschaft angegebene Datenquelle mehrere Datenquellen enthält, geben Sie mithilfe der DataMember-Eigenschaft die bestimmte Quelle an, die an das Steuerelement gebunden werden soll. Bei einem System.Data.DataSet mit mehreren Tabellen müssen Sie z. B. angeben, welche Tabelle an das Steuerelement gebunden werden soll. Nachdem Sie die Datenquelle angegeben haben, binden Sie diese mithilfe der DataBind-Methode an das Steuerelement.
Sie können auch mit der DataSourceID-Eigenschaft automatisch eine Bindung zu einer durch ein Datenquellen-Steuerelement dargestellten Datenquelle herstellen. Wenn Sie die DataSourceID-Eigenschaft festlegen, wird das Repeater-Steuerelement automatisch an das angegebene Datenquellen-Steuerelement gebunden. Es ist nicht erforderlich, Code zu schreiben, der die DataBind-Methode explizit aufruft, es sei denn, die Eigenschaften des Repeater-Steuerelements werden dynamisch geändert.
Wenn Werte für die DataSource-Eigenschaft und für die DataSourceID-Eigenschaft angegeben werden, kann ASP.NET die Datenquelle nicht auflösen, und es wird eine System.Web.HttpException ausgelöst.
Beispiel
Das folgende Beispiel veranschaulicht, wie beim Laden der Seite die DataSource für das Repeater-Steuerelement angegeben wird.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<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 runat=server>
<b>Repeater1:</b>
<p>
<asp:Repeater id=Repeater1 runat="server">
<HeaderTemplate>
<table border=1>
</HeaderTemplate>
<ItemTemplate>
<tr>
<td> <%# Container.DataItem %> </td>
</tr>
</ItemTemplate>
<FooterTemplate>
</table>
</FooterTemplate>
</asp:Repeater>
<p>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<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 runat=server>
<b>Repeater1:</b>
<p>
<asp:Repeater id=Repeater1 runat="server">
<HeaderTemplate>
<table border=1>
</HeaderTemplate>
<ItemTemplate>
<tr>
<td> <%# Container.DataItem %> </td>
</tr>
</ItemTemplate>
<FooterTemplate>
</table>
</FooterTemplate>
</asp:Repeater>
<p>
</form>
</body>
</html>
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
Repeater-Klasse
Repeater-Member
System.Web.UI.WebControls-Namespace
Repeater.DataMember-Eigenschaft
DataSourceID