TemplateField Classe

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 visualizza 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 a 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 predefiniti del controllo dati (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 a dati in cui viene utilizzato. 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 alternati 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 TemplateField oggetto in un 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 una didascalia nelle sezioni dell'intestazione o del piè di pagina, impostare rispettivamente la HeaderText FooterText proprietà o . 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.

Annotazioni

Alcuni controlli associati a dati,ad esempio il GridView controllo, possono mostrare o nascondere solo l'intera sezione di 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, utilizzare 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à di 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

Nome	Descrizione
TemplateField()	Inizializza una nuova istanza della classe TemplateField.

Proprietà

Nome	Descrizione
AccessibleHeaderText	Ottiene o imposta il testo di cui viene eseguito il rendering come valore della `AbbreviatedText` proprietà in alcuni controlli. (Ereditato da DataControlField)
AlternatingItemTemplate	Ottiene o imposta il modello per la visualizzazione degli elementi alternati in un TemplateField oggetto .
Control	Ottiene un riferimento al controllo dati a cui è associato l'oggetto DataControlField . (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 che indica se il valore a cui è associato l'oggetto TemplateField deve essere convertito `null` in se è Empty.
DesignMode	Ottiene un valore che indica se un campo di controllo dati è attualmente visualizzato in un ambiente in fase di progettazione. (Ereditato da DataControlField)
EditItemTemplate	Ottiene o imposta il modello per la visualizzazione di un elemento in modalità di modifica in un TemplateField oggetto .
FooterStyle	Ottiene o imposta lo stile del piè di pagina del campo del controllo dati. (Ereditato da DataControlField)
FooterTemplate	Ottiene o imposta il modello per la visualizzazione della sezione piè di pagina di un TemplateField oggetto .
FooterText	Ottiene o imposta il testo visualizzato nell'elemento piè di pagina di un campo del controllo dati. (Ereditato da DataControlField)
HeaderImageUrl	Ottiene o imposta l'URL di un'immagine visualizzata nell'elemento di intestazione di un campo di controllo dati. (Ereditato da DataControlField)
HeaderStyle	Ottiene o imposta lo stile dell'intestazione del campo del controllo dati. (Ereditato da DataControlField)
HeaderTemplate	Ottiene o imposta il modello per la visualizzazione della sezione dell'intestazione di un TemplateField oggetto .
HeaderText	Ottiene o imposta il testo visualizzato nell'elemento di intestazione di un campo del controllo dati. (Ereditato da DataControlField)
InsertItemTemplate	Ottiene o imposta il modello per la visualizzazione di un elemento in modalità di inserimento in un TemplateField oggetto .
InsertVisible	Ottiene un valore che indica se l'oggetto è visibile quando il DataControlField controllo associato a dati padre è in modalità di inserimento. (Ereditato da DataControlField)
IsTrackingViewState	Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate allo stato di visualizzazione. (Ereditato da DataControlField)
ItemStyle	Ottiene lo stile di qualsiasi contenuto basato su testo visualizzato da un campo di controllo dati. (Ereditato da DataControlField)
ItemTemplate	Ottiene o imposta il modello per la visualizzazione di un elemento in un controllo associato a dati.
ShowHeader	Ottiene o imposta un valore che indica se viene eseguito il rendering dell'elemento di intestazione di un campo del controllo dati. (Ereditato da DataControlField)
SortExpression	Ottiene o imposta un'espressione di ordinamento 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 client.
ViewState	Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un DataControlField oggetto in 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

Nome	Descrizione
CloneField()	Crea una copia duplicata dell'oggetto derivato da corrente DataControlField. (Ereditato da DataControlField)
CopyProperties(DataControlField)	Copia le proprietà dell'oggetto derivato da corrente TemplateFieldnell'oggetto specificato DataControlField .
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 del controllo dati come specificato da una o più istruzioni di associazione bidirezionali (`DataBind`) dalla cella della tabella corrente e aggiunge i valori alla raccolta specificata IOrderedDictionary .
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
Initialize(Boolean, Control)	Esegue l'inizializzazione di istanza di base per un campo di controllo dati. (Ereditato da DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Aggiunge testo o controlli alla raccolta di controlli di una cella.
LoadViewState(Object)	Ripristina lo stato di visualizzazione salvata in precedenza della vista origine dati. (Ereditato da DataControlField)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
OnFieldChanged()	Genera l'evento `FieldChanged`. (Ereditato da DataControlField)
SaveViewState()	Salva le modifiche apportate allo stato di DataControlField visualizzazione dal momento in cui la pagina è stata pubblicata nel server. (Ereditato da DataControlField)
ToString()	Restituisce una stringa che rappresenta questo DataControlField oggetto. (Ereditato da DataControlField)
TrackViewState()	Fa in modo che l'oggetto DataControlField possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nella proprietà del ViewState controllo e mantenute tra le richieste per la stessa pagina. (Ereditato da DataControlField)
ValidateSupportsCallback()	Determina se i controlli contenuti in un TemplateField oggetto supportano i callback di pagina.

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Ottiene o imposta lo schema associato a questo DataControlField oggetto. (Ereditato da DataControlField)
IStateManager.IsTrackingViewState	Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate allo stato di visualizzazione. (Ereditato da DataControlField)
IStateManager.LoadViewState(Object)	Ripristina lo stato di visualizzazione salvato in precedenza del campo del controllo dati. (Ereditato da DataControlField)
IStateManager.SaveViewState()	Salva le modifiche apportate allo stato di DataControlField visualizzazione dal momento in cui la pagina è stata pubblicata nel server. (Ereditato da DataControlField)
IStateManager.TrackViewState()	Fa in modo che l'oggetto DataControlField possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nella proprietà del ViewState controllo e mantenute tra le richieste per la stessa pagina. (Ereditato da DataControlField)

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?