Controllo Repeater

  • Articolo

Repeater è un controllo contenitore che consente di creare elenchi personalizzati da qualsiasi dato disponibile per la pagina. Il controllo Repeater non dispone di un proprio rendering incorporato, pertanto è necessario fornire il layout al controllo Repeater mediante la creazione di modelli. Quando si esegue la pagina, il controllo Repeater scorre in ciclo i record dell'origine dati ed esegue il rendering di un elemento per ogni record.

Non disponendo di un aspetto predefinito, è possibile utilizzare il controllo Repeater per creare vari tipi di elenchi, inclusi:

  • Layout di tabella.

  • Elenco delimitato da virgole, ad esempio: "a, b, c, d" e così via.

  • Elenco in formato XML.

Per aggiungere un controllo Repeater a una pagina

  • Trascinare il controllo Repeater dal pannello Casella degli strumenti nella pagina.

Dopo aver aggiunto un controllo Repeater, è possibile specificarne un'origine dati.

Per associare il controllo Repeater a un'origine dati

  1. Nella visualizzazione Progettazione, fare clic con il pulsante destro del mouse sul controllo Repeater, quindi scegliere Mostra attività controlli comuni.

  2. Scegliere Scegli origine dati dal menu Attività comuni di DropDownList.

  3. Nella Configurazione guidata origine dati scegliere un'origine per il controllo Repeater. Per ulteriori informazioni, vedere Configurare un'origine dati utilizzando un controllo associato a dati.

Per utilizzare il controllo Repeater, è necessario creare modelli che ne definiscano il layout del contenuto. I modelli possono contenere qualsiasi combinazione di tag e controlli. Se non viene definito alcun modello o se nessuno dei modelli contiene elementi, il controllo non viene visualizzato nella pagina quando viene eseguita l'applicazione.

Per creare modelli per il controllo Repeater

  1. Nella visualizzazione Codice posizionare il punto di inserimento tra i tag <asp:Repeater></asp:Repeater>.

  2. Premere il tasto Minore di (<) per aprire la casella di riepilogo di completamento del codice.

  3. Fare clic sul modello da creare.

  4. Digitare il codice HTML desiderato per il modello. Per un esempio di definizioni di modello, vedere la Procedura Cc295084.xtlink_newWindow(it-it,Expression.40).png in MSDN library.

Nell'elenco seguente sono descritti i modelli Repeater supportati dal controllo Repeater:

  • ItemTemplate Include i controlli e gli elementi HTML di cui deve essere eseguito il rendering una volta per ogni elemento di dati contenuto nell'origine dati.

  • AlternatingItemTemplate Include i controlli e gli elementi HTML di cui deve essere eseguito il rendering una volta ogni due elementi di dati contenuti nell'origine dati. In genere, questo modello viene utilizzato per creare un aspetto diverso per gli elementi alternati, ad esempio uno sfondo diverso dal colore specificato in ItemTemplate.

  • HeaderTemplate e FooterTemplate Includono il testo e i controlli di cui deve essere eseguito il rendering rispettivamente all'inizio e alla fine dell'elenco.

  • SeparatorTemplate Include gli elementi di cui deve essere eseguito il rendering tra ciascun elemento. Un esempio tipico potrebbe essere una riga, tramite un elemento HR.

Per ulteriori informazioni sull'utilizzo del controllo Repeater, vedere Cenni preliminari sul controllo server Web Repeater Cc295084.xtlink_newWindow(it-it,Expression.40).png in MSDN Library.

Vedere anche

Concetti

Utilizzo dei siti ASP.NET
Controllo DataList
Controllo DetailsView
Controllo FormView
Controllo GridView