Repeater.DataSource Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta l'origine dati che fornisce i dati per popolare l'elenco.
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 ObjectValore della proprietà
Oggetto IEnumerable o IListSource che contiene una raccolta di valori utilizzata per fornire dati a questo controllo. Il valore predefinito è null.
- Attributi
Eccezioni
L'oggetto DataSource specificato non è un'origine di dati supportata per il Repeater controllo .
Impossibile risolvere l'origine dati perché viene specificato un valore sia per la DataSource proprietà che per la DataSourceID proprietà .
Esempio
Nell'esempio seguente viene illustrato come specificare l'oggetto DataSourceRepeater del controllo quando viene caricata la pagina.
<%@ 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>
Commenti
Utilizzare questa proprietà per specificare l'origine dei dati per popolare il Repeater controllo. DataSource può essere qualsiasi System.Collections.IEnumerable raccolta, ad esempio un System.Data.DataView oggetto per l'accesso a database, un oggetto o una System.Collections.ArrayListmatrice o un IListSource oggetto . Quando si imposta la DataSource proprietà è necessario scrivere manualmente il codice da associare all'origine dati.
Se l'origine dati specificata dalla DataSource proprietà contiene più origini di dati, utilizzare la DataMember proprietà per specificare l'origine specifica da associare al controllo. Ad esempio, se si dispone di un System.Data.DataSet oggetto con più tabelle, è necessario specificare la tabella da associare al controllo. Dopo aver specificato l'origine dati, usare il DataBind metodo per associare l'origine dati al controllo.
In alternativa, è possibile utilizzare la proprietà per eseguire automaticamente l'associazione DataSourceID a un'origine dati rappresentata da un controllo origine dati. Quando si imposta la DataSourceID proprietà , il Repeater controllo viene associato automaticamente al controllo origine dati specificato. Non è necessario scrivere codice che chiami in modo esplicito il DataBind metodo, a meno che non si modifichi dinamicamente le proprietà del Repeater controllo.
Se i valori vengono specificati sia per la DataSource proprietà che per la DataSourceID proprietà , ASP.NET non è in grado di risolvere l'origine dati e viene generata un'eccezione System.Web.HttpException .
