TemplateField Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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.

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à: Object

DataControlField
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