Repeater.DataSource Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit la source de données qui fournit des données pour remplir la liste.
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 ObjectValeur de propriété
Objet IEnumerable qui IListSource contient une collection de valeurs utilisées pour fournir des données à ce contrôle. La valeur par défaut est null.
- Attributs
Exceptions
L’objet DataSource spécifié n’est pas une source de données prise en charge pour le Repeater contrôle.
Impossible de résoudre la source de données, car une valeur est spécifiée pour la DataSource propriété et la DataSourceID propriété.
Exemples
L’exemple suivant montre comment spécifier le DataSourceRepeater contrôle lorsque la page est chargée.
<%@ 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>
Remarques
Utilisez cette propriété pour spécifier la source de données pour remplir le Repeater contrôle. Il DataSource peut s’agir de n’importe quelle System.Collections.IEnumerable collection telle qu’une System.Data.DataView collection permettant d’accéder aux bases de données, à un System.Collections.ArrayListtableau ou à un IListSource objet. Lorsque vous définissez la DataSource propriété, vous devez écrire manuellement le code pour établir une liaison à la source de données.
Si la source de données spécifiée par la DataSource propriété contient plusieurs sources de données, utilisez la DataMember propriété pour spécifier la source spécifique à lier au contrôle. Par exemple, si vous avez une System.Data.DataSet table avec plusieurs tables, vous devez spécifier la table à lier au contrôle. Une fois que vous avez spécifié la source de données, utilisez la DataBind méthode pour lier la source de données au contrôle.
Vous pouvez également utiliser la DataSourceID propriété pour lier automatiquement une source de données représentée par un contrôle de source de données. Lorsque vous définissez la DataSourceID propriété, le Repeater contrôle est automatiquement lié au contrôle de source de données spécifié. Vous n’avez pas besoin d’écrire du code qui appelle explicitement la DataBind méthode, sauf si vous modifiez dynamiquement les propriétés du Repeater contrôle.
Si les valeurs sont spécifiées à la fois pour la DataSource propriété et la DataSourceID propriété, ASP.NET n’est pas en mesure de résoudre la source de données et un System.Web.HttpException est levée.
