Proprietà DataList.SeparatorTemplate
Aggiornamento: novembre 2007
Ottiene o imposta il modello per il separatore tra gli elementi del controllo DataList.
Assembly: System.Web (in System.Web.dll)
[PersistenceModeAttribute(PersistenceMode.InnerProperty)] [BrowsableAttribute(false)] [TemplateContainerAttribute(typeof(DataListItem))] public virtual ITemplate SeparatorTemplate { get; set; }
/** @property */ /** @attribute PersistenceModeAttribute(PersistenceMode.InnerProperty) */ /** @attribute BrowsableAttribute(false) */ /** @attribute TemplateContainerAttribute(DataListItem) */ public ITemplate get_SeparatorTemplate() /** @property */ /** @attribute PersistenceModeAttribute(PersistenceMode.InnerProperty) */ /** @attribute BrowsableAttribute(false) */ /** @attribute TemplateContainerAttribute(DataListItem) */ public void set_SeparatorTemplate(ITemplate value)
public function get SeparatorTemplate () : ITemplate public function set SeparatorTemplate (value : ITemplate)
<asp:DataList> <SeparatorTemplate>ITemplate</SeparatorTemplate> </asp:DataList>
Valore proprietà
Tipo: System.Web.UI.ITemplateOggetto System.Web.UI.ITemplate che contiene il modello per il separatore tra gli elementi del controllo DataList. Il valore predefinito è null.
Utilizzare la proprietà SeparatorTemplate per controllare il contenuto del separatore tra gli elementi del controllo DataList. Il separatore consente l'inserimento di un elemento con contenuti personalizzati tra ciascun elemento del controllo DataList. L'aspetto del separatore tra gli elementi del controllo DataList viene controllato mediante la proprietà SeparatorStyle.
Per specificare un modello per il separatore, inserire i tag <SeparatorTemplate> tra i tag di apertura e di chiusura del controllo DataList. È quindi possibile elencare il contenuto del modello inserito tra i tag <SeparatorTemplate> di apertura e di chiusura.
 Attenzione: |
|---|
Il controllo può essere utilizzato per visualizzare l'input dell'utente, che potrebbe includere uno script non autorizzato. Verificare tutte le informazioni inviate da un client per uno script eseguibile, istruzioni SQL o altro codice, prima di visualizzarle nell'applicazione. È possibile utilizzare controlli di convalida per verificare l'input dell'utente prima di visualizzare il testo immesso in un controllo. ASP.NET dispone di una funzionalità di convalida della richiesta di input per bloccare script e codice HTML nell'input dell'utente. Per ulteriori informazioni, vedere Protezione dei controlli standard, Procedura: proteggere da attacchi tramite script in un'applicazione Web applicando alle stringhe la codifica HTML e Convalida dell'input utente nelle pagine Web ASP.NET. |
| Topic | Location |
|---|---|
| Procedura: creare modelli di controlli server Web ASP.NET | Generazione di applicazioni Web ASP.NET |
| Procedura: creare modelli di controlli Web ASP.NET in modo dichiarativo | Generazione di applicazioni Web ASP.NET |
| Procedura: creare modelli di controlli Web ASP.NET in modo dichiarativo | Compilazione di applicazioni Web ASP.NET in Visual Studio |
Nell'esempio di codice riportato di seguito viene illustrato come utilizzare la proprietà SeparatorTemplate per definire il contenuto del separatore di ciascun elemento del controllo DataList.
| Nota: |
|---|
Ll'esempio di codice riportato di seguito utilizza il modello di codice a file singolo e potrebbe non funzionare in modo corretto se venisse copiato direttamente in un file code-behind. È necessario copiare l'esempio di codice in un file di testo vuoto con estensione ASPX. Per ulteriori informazioni sul modello di codice dei Web Form, vedere Modello di codice di pagine Web ASP.NET. |
<%@ Page Language="C#" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <!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" > <script runat="server"> ICollection CreateDataSource() { // Create sample data for the DataList control. DataTable dt = new DataTable(); DataRow dr; // Define the columns of the table. dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32))); dt.Columns.Add(new DataColumn("StringValue", typeof(String))); dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double))); dt.Columns.Add(new DataColumn("ImageValue", typeof(String))); // Populate the table with sample values. for (int i = 0; i < 9; i++) { dr = dt.NewRow(); dr[0] = i; dr[1] = "Description for item " + i.ToString(); dr[2] = 1.23 * (i + 1); dr[3] = "Image" + i.ToString() + ".jpg"; dt.Rows.Add(dr); } DataView dv = new DataView(dt); return dv; } void Page_Load(Object sender, EventArgs e) { // Load sample data only once, when the page is first loaded. if (!IsPostBack) { ItemsList.DataSource = CreateDataSource(); ItemsList.DataBind(); } } void Selection_Change(Object sender, EventArgs e) { // Set the background color for the separator section of // the DataList control. ItemsList.SeparatorStyle.BackColor = System.Drawing.Color.FromName(ItemList.SelectedItem.Value); } </script> <head runat="server"> <title>DataList SeparatorTemplate and SeparatorStyle Example</title> </head> <body> <form id="form1" runat="server"> <h3>DataList SeparatorTemplate and SeparatorStyle Example</h3> Select a background color for the separator between items in the DataList. <br /><br /> <asp:DataList id="ItemsList" BorderColor="black" CellPadding="5" CellSpacing="5" RepeatDirection="Vertical" RepeatLayout="Table" RepeatColumns="3" ShowFooter="True" runat="server"> <HeaderStyle BackColor="#aaaadd"> </HeaderStyle> <ItemStyle BackColor="Silver"> </ItemStyle> <AlternatingItemStyle BackColor="DarkGray"> </AlternatingItemStyle> <SeparatorStyle BackColor="White"> </SeparatorStyle> <HeaderTemplate> List of items </HeaderTemplate> <ItemTemplate> Description: <br /> <%# DataBinder.Eval(Container.DataItem, "StringValue") %> <br /> Price: <%# DataBinder.Eval(Container.DataItem, "CurrencyValue", "{0:c}") %> <br /> <asp:Image id="ProductImage" AlternatingText='<%# DataBinder.Eval(Container.DataItem, "StringValue") %>' ImageUrl='<%# DataBinder.Eval(Container.DataItem, "ImageValue") %>' runat="server"/> </ItemTemplate> <SeparatorTemplate> <asp:Image id="SeparatorImage" GenerateEmptyAlternateText='true' ImageUrl="SeparatorImage.jpg" runat="server"/> </SeparatorTemplate> </asp:DataList> <hr /> <table cellpadding="5"> <tr> <td> Separator BackColor: </td> </tr> <tr> <td> <asp:DropDownList id="ItemList" AutoPostBack="True" OnSelectedIndexChanged="Selection_Change" runat="server"> <asp:ListItem Selected="True" Value="White"> White </asp:ListItem> <asp:ListItem Value="Silver"> Silver </asp:ListItem> <asp:ListItem Value="DarkGray"> Dark Gray </asp:ListItem> <asp:ListItem Value="Khaki"> Khaki </asp:ListItem> <asp:ListItem Value="DarkKhaki"> Dark Khaki </asp:ListItem> </asp:DropDownList> </td> </tr> </table> </form> </body> </html>
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition , Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Aggiunte alla community
AGGIUNGI
Si desidera partecipare?
