Condividi tramite


TemplateField Classe

Definizione

Rappresenta un campo che mostra contenuto personalizzato in un controllo associato a dati.

public ref class TemplateField : System::Web::UI::WebControls::DataControlField
public class TemplateField : System.Web.UI.WebControls.DataControlField
type TemplateField = class
    inherit DataControlField
Public Class TemplateField
Inherits DataControlField
Ereditarietà
TemplateField

Esempio

Nell'esempio di codice seguente viene illustrato come creare un oggetto personalizzato TemplateField che visualizza due campi nella stessa cella. I campi nome e cognome vengono combinati nello stesso TemplateField oggetto.


<%@ Page language="C#" %>

<!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 runat="server">
    <title>TemplateField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>TemplateField Example</h3>

      <!-- Populate the Columns collection declaratively. -->
      <!-- Create a custom TemplateField column that uses      -->
      <!-- two Label controls to display an author's first and -->
      <!-- last name in the same column.                       -->
      <asp:gridview id="AuthorsGridView" 
        datasourceid="AuthorsSqlDataSource" 
        autogeneratecolumns="False"
        runat="server">
                
        <columns>
                
          <asp:templatefield headertext="Author Name">
            <itemtemplate>
              <asp:label id="FirstNameLabel"
                Text= '<%# Eval("au_fname") %>'
                runat="server"/> 
              <asp:label id="LastNameLabel"
                Text= '<%# Eval("au_lname") %>'
                runat="server"/>
            </itemtemplate>
          </asp:templatefield>
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Pubs sample database.                        -->
      <asp:sqldatasource id="AuthorsSqlDataSource"  
        selectcommand="SELECT [au_lname], [au_fname], [address], [city], [state], [zip], [contract] FROM [authors]"
        connectionstring="server=localhost;database=pubs;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

<%@ Page language="VB" %>

<!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 runat="server">
    <title>TemplateField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>TemplateField Example</h3>

      <!-- Populate the Columns collection declaratively. -->
      <!-- Create a custom TemplateField column that uses      -->
      <!-- two Label controls to display an author's first and -->
      <!-- last name in the same column.                       -->
      <asp:gridview id="AuthorsGridView" 
        datasourceid="AuthorsSqlDataSource" 
        autogeneratecolumns="False"
        runat="server">
                
        <columns>
                
          <asp:templatefield headertext="Author Name">
            <itemtemplate>
              <asp:label id="FirstNameLabel"
                text= '<%# Eval("au_fname") %>'
                runat="server"/> 
              <asp:label id="LastNameLabel"
                text= '<%# Eval("au_lname") %>'
                runat="server"/>
            </itemtemplate>
          </asp:templatefield>
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Pubs sample database.                        -->
      <asp:sqldatasource id="AuthorsSqlDataSource"  
        selectcommand="SELECT [au_lname], [au_fname], [address], [city], [state], [zip], [contract] FROM [authors]"
        connectionstring="server=localhost;database=pubs;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Commenti

La TemplateField classe viene usata dai controlli associati ai dati (ad esempio GridView e DetailsView) per visualizzare contenuto personalizzato per ogni record visualizzato. Quando è necessario visualizzare il contenuto in un controllo associato a dati non fornito da uno dei campi di controllo dati predefiniti (ad esempio BoundField), usare la classe per creare l'interfaccia TemplateField utente personalizzata. L'oggetto TemplateField viene visualizzato in modo diverso a seconda del controllo associato ai dati in cui viene usato. Ad esempio, il GridView controllo visualizza un TemplateField oggetto come colonna e il DetailsView controllo lo visualizza come riga.

È possibile definire un modello personalizzato per le diverse parti dell'oggetto TemplateField usando i modelli elencati nella tabella seguente.

Modello Descrizione
AlternatingItemTemplate Specifica il contenuto da visualizzare per gli elementi alternativi in un TemplateField oggetto.
EditItemTemplate Specifica il contenuto da visualizzare per un elemento in modalità di modifica in un TemplateField oggetto.
FooterTemplate Specifica il contenuto da visualizzare per la sezione piè di pagina di un TemplateField oggetto.
HeaderTemplate Specifica il contenuto da visualizzare per la sezione intestazione di un TemplateField oggetto.
InsertItemTemplate Specifica il contenuto da visualizzare per un elemento in modalità di inserimento in un TemplateField oggetto. Questo modello è supportato solo dal DetailsView controllo.
ItemTemplate Specifica il contenuto da visualizzare per gli elementi in un TemplateField oggetto.

È possibile nascondere un oggetto in un TemplateField controllo associato a dati impostando la Visible proprietà su false.

In alternativa alla definizione di un modello o personalizzatoHeaderTemplate, è possibile personalizzare le sezioni intestazione e piè di pagina di un TemplateField oggetto impostando altre proprietà dell'oggettoTemplateField.FooterTemplate Per visualizzare un didascalia nelle sezioni intestazione o piè di pagina, impostare rispettivamente la HeaderText proprietà o .FooterText Anziché visualizzare il testo nella sezione intestazione, è possibile visualizzare un'immagine impostando la HeaderImageUrl proprietà. La sezione intestazione può essere nascosta nell'oggetto TemplateField impostando la ShowHeader proprietà su false.

Nota

Alcuni controlli associati a dati ,ad esempio il GridView controllo, possono visualizzare o nascondere solo l'intera sezione dell'intestazione del controllo. Questi controlli associati a dati non supportano la ShowHeader proprietà per un singolo campo associato. Per visualizzare o nascondere l'intera sezione dell'intestazione di un controllo associato a dati, usare la proprietà del ShowHeader controllo , se disponibile.

È anche possibile personalizzare l'aspetto dell'oggetto TemplateField (colore del carattere, colore di sfondo e così via) impostando le proprietà dello stile per le diverse parti del campo. Nella tabella seguente sono elencate le diverse proprietà di stile.

Proprietà Style Descrizione
ControlStyle Impostazioni di stile per i controlli server Web figlio dell'oggetto TemplateField .
FooterStyle Impostazioni di stile per la sezione piè di pagina dell'oggetto TemplateField .
HeaderStyle Impostazioni di stile per la sezione intestazione dell'oggetto TemplateField .
ItemStyle Impostazioni di stile per gli elementi di dati nell'oggetto TemplateField .

Costruttori

TemplateField()

Inizializza una nuova istanza della classe TemplateField.

Proprietà

AccessibleHeaderText

Ottiene o imposta il testo che viene sottoposto a rendering come valore della proprietà AbbreviatedText in alcuni controlli.

(Ereditato da DataControlField)
AlternatingItemTemplate

Ottiene o imposta il modello per visualizzare elementi alternativi in un oggetto TemplateField.

Control

Ottiene un riferimento al controllo dati a cui l'oggetto DataControlField è associato.

(Ereditato da DataControlField)
ControlStyle

Ottiene lo stile di tutti i controlli server Web contenuti nell'oggetto DataControlField.

(Ereditato da DataControlField)
ConvertEmptyStringToNull

Ottiene o imposta un valore indicante se il valore a cui è associato l'oggetto TemplateField deve essere convertito in null se è Empty.

DesignMode

Ottiene un valore che indica se un campo di controllo dati è attualmente visualizzato in un ambiente di progettazione.

(Ereditato da DataControlField)
EditItemTemplate

Ottiene o imposta il modello per visualizzare un elemento in modalità di modifica in un oggetto TemplateField.

FooterStyle

Ottiene o imposta lo stile del piè di pagina del campo di controllo dati.

(Ereditato da DataControlField)
FooterTemplate

Ottiene o imposta il modello per visualizzare la sezione del piè di pagina di un oggetto TemplateField.

FooterText

Ottiene o imposta il testo visualizzato nell'elemento del piè di pagina del campo di controllo dati.

(Ereditato da DataControlField)
HeaderImageUrl

Ottiene o imposta l'URL di un'immagine che viene visualizzata nell'elemento di intestazione di un campo di controlli dati.

(Ereditato da DataControlField)
HeaderStyle

Ottiene o imposta lo stile dell'intestazione del campo di controllo dati.

(Ereditato da DataControlField)
HeaderTemplate

Ottiene o imposta il modello per visualizzare la sezione di intestazione di un oggetto TemplateField.

HeaderText

Ottiene o imposta il testo visualizzato nell'elemento dell'intestazione di un campo di controllo dati.

(Ereditato da DataControlField)
InsertItemTemplate

Ottiene o imposta il modello per visualizzare un elemento in modalità di inserimento in un oggetto TemplateField.

InsertVisible

Ottiene un valore che indica se l'oggetto DataControlField è visibile quando il controllo con associazione a dati padre si trova in modalità di inserimento.

(Ereditato da DataControlField)
IsTrackingViewState

Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate al relativo stato di visualizzazione.

(Ereditato da DataControlField)
ItemStyle

Ottiene lo stile di tutti i contenuti basati sul testo visualizzati da un campo di controllo dati.

(Ereditato da DataControlField)
ItemTemplate

Ottiene o imposta il modello per visualizzare un elemento in un controllo con associazione a dati.

ShowHeader

Ottiene o imposta un valore che indica se viene eseguito il rendering dell'elemento di intestazione di un campo di controllo dati.

(Ereditato da DataControlField)
SortExpression

Ottiene o imposta l'espressione di ordinamento che viene utilizzata da un controllo origine dati per ordinare i dati.

(Ereditato da DataControlField)
ValidateRequestMode

Ottiene o imposta un valore che specifica se il controllo convalida l'input del client.

ValidateRequestMode

Ottiene o imposta un valore che specifica se il controllo convalida l'input del client.

(Ereditato da DataControlField)
ViewState

Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un oggetto DataControlField tra più richieste per la stessa pagina.

(Ereditato da DataControlField)
Visible

Ottiene o imposta un valore che indica se viene eseguito il rendering di un campo di controllo dati.

(Ereditato da DataControlField)

Metodi

CloneField()

Crea una copia duplicata dell'oggetto corrente derivato da DataControlField.

(Ereditato da DataControlField)
CopyProperties(DataControlField)

Copia le proprietà dell'oggetto corrente derivato da TemplateField nell'oggetto DataControlField specificato.

CreateField()

Crea un nuovo oggetto TemplateField.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Estrae il valore dei campi di controllo dei dati come specificato da una o più istruzioni di associazione bidirezionale (DataBind) dalla cella corrente della tabella e aggiunge i valori all'insieme IOrderedDictionary specificato.

GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
Initialize(Boolean, Control)

Esegue un'inizializzazione dell'istanza di base per un campo di controllo dati.

(Ereditato da DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Aggiunge testo o controlli all'insieme dei controlli di una cella.

LoadViewState(Object)

Ripristina lo stato di visualizzazione precedentemente salvato della visualizzazione origine dati.

(Ereditato da DataControlField)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
OnFieldChanged()

Genera l'evento FieldChanged.

(Ereditato da DataControlField)
SaveViewState()

Salva le modifiche apportate allo stato di visualizzazione DataControlField dal momento in cui è stato eseguito il postback della pagina al server.

(Ereditato da DataControlField)
ToString()

Restituisce una stringa che rappresenta questo oggetto DataControlField.

(Ereditato da DataControlField)
TrackViewState()

Mediante questo metodo l'oggetto DataControlField tiene traccia delle modifiche apportate al relativo stato di visualizzazione in modo che possano essere memorizzate nella proprietà ViewState del controllo e mantenute nelle richieste della stessa pagina.

(Ereditato da DataControlField)
ValidateSupportsCallback()

Determina se i controlli contenuti in un oggetto TemplateField supportano i callback di pagina.

Implementazioni dell'interfaccia esplicita

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Ottiene o imposta lo schema associato all'oggetto DataControlField.

(Ereditato da DataControlField)
IStateManager.IsTrackingViewState

Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate al relativo stato di visualizzazione.

(Ereditato da DataControlField)
IStateManager.LoadViewState(Object)

Ripristina lo stato di visualizzazione del campo del controllo dati salvato in precedenza.

(Ereditato da DataControlField)
IStateManager.SaveViewState()

Salva le modifiche apportate allo stato di visualizzazione DataControlField dal momento in cui è stato eseguito il postback della pagina al server.

(Ereditato da DataControlField)
IStateManager.TrackViewState()

Mediante questo metodo l'oggetto DataControlField tiene traccia delle modifiche apportate al relativo stato di visualizzazione in modo che possano essere memorizzate nella proprietà ViewState del controllo e mantenute nelle richieste della stessa pagina.

(Ereditato da DataControlField)

Si applica a

Vedi anche