Questa documentazione è stata archiviata e non viene gestita.

Proprietà DataList.SelectedItemTemplate

Aggiornamento: novembre 2007

Ottiene o imposta il modello per l'elemento selezionato nel controllo DataList.

Spazio dei nomi:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

[TemplateContainerAttribute(typeof(DataListItem))]
[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
[BrowsableAttribute(false)]
public virtual ITemplate SelectedItemTemplate { get; set; }
/** @property */
/** @attribute TemplateContainerAttribute(DataListItem) */
/** @attribute PersistenceModeAttribute(PersistenceMode.InnerProperty) */
/** @attribute BrowsableAttribute(false) */
public ITemplate get_SelectedItemTemplate()
/** @property */
/** @attribute TemplateContainerAttribute(DataListItem) */
/** @attribute PersistenceModeAttribute(PersistenceMode.InnerProperty) */
/** @attribute BrowsableAttribute(false) */
public  void set_SelectedItemTemplate(ITemplate value)

public function get SelectedItemTemplate () : ITemplate
public function set SelectedItemTemplate (value : ITemplate)
<asp:DataList>
	<SelectedItemTemplate>ITemplate</SelectedItemTemplate>
</asp:DataList>

Valore proprietà

Tipo: System.Web.UI.ITemplate

Oggetto System.Web.UI.ITemplate che contiene il modello per l'elemento selezionato nel controllo DataList. Il valore predefinito è null.

Utilizzare la proprietà SelectedItemTemplate per controllare il contenuto dell'elemento selezionato. L'aspetto dell'elemento selezionato viene controllato mediante la proprietà SelectedItemStyle.

Per specificare un modello per l'elemento selezionato, inserire i tag <SelectedItemTemplate> tra i tag di apertura e di chiusura del controllo DataList. È quindi possibile elencare il contenuto del modello inserito tra i tag <SelectedItemTemplate> 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.

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare la proprietà SelectedItemTemplate per definire il contenuto dell'elemento selezionato 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" >
<head>
    <title>DataList Select Example</title>
<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("Item", typeof(Int32)));
         dt.Columns.Add(new DataColumn("Qty", typeof(Int32)));
         dt.Columns.Add(new DataColumn("Price", typeof(double)));

         // Populate the table with sample values.
         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();

            dr[0] = i;
            dr[1] = i * 2;
            dr[2] = 1.23 * (i + 1);

            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 Item_Command(Object sender, DataListCommandEventArgs e) 
      {

         // Set the SelectedIndex property to select an item in the DataList.
         ItemsList.SelectedIndex = e.Item.ItemIndex;

         // Rebind the data source to the DataList to refresh the control.
         ItemsList.DataSource = CreateDataSource();
         ItemsList.DataBind();

      }

   </script>

</head>
<body>

   <form id="form1" runat="server">

      <h3>DataList Select Example</h3>

      Click <b>Select</b> to select an item.

      <br /><br />

      <asp:DataList id="ItemsList"
           GridLines="Both"
           CellPadding="3"
           CellSpacing="0"           
           OnItemCommand="Item_Command"
           runat="server">

         <HeaderStyle BackColor="#aaaadd">
         </HeaderStyle>

         <AlternatingItemStyle BackColor="Gainsboro">
         </AlternatingItemStyle>

         <SelectedItemStyle BackColor="Yellow">
         </SelectedItemStyle>

         <HeaderTemplate>

            Items

         </HeaderTemplate>

         <ItemTemplate>

            <asp:LinkButton id="SelectButton" 
                 Text="Select" 
                 CommandName="Select"
                 runat="server"/>

            Item <%# DataBinder.Eval(Container.DataItem, "Item") %>

         </ItemTemplate>

         <SelectedItemTemplate>

            Item:
            <asp:Label id="ItemLabel" 
                 Text='<%# DataBinder.Eval(Container.DataItem, "Item") %>' 
                 runat="server"/>

            <br />

            Quantity:
            <asp:Label id="QtyLabel" 
                 Text='<%# DataBinder.Eval(Container.DataItem, "Qty") %>' 
                 runat="server"/>

            <br />

            Price:
            <asp:Label id="PriceLabel" 
                 Text='<%# DataBinder.Eval(Container.DataItem, "Price", "{0:c}") %>' 
                 runat="server"/>

         </SelectedItemTemplate>

      </asp:DataList>

   </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.

.NET Framework

Supportato in: 3.5, 3.0, 2.0, 1.1, 1.0
Mostra: