TemplateField TemplateField TemplateField TemplateField Class

Definizione

Rappresenta un campo che mostra contenuto personalizzato in un controllo associato a dati.Represents a field that displays custom content in a data-bound control.

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à

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come TemplateField creare un oggetto personalizzato che visualizza due campi nella stessa cella.The following code example demonstrates how to create a custom TemplateField object that displays two fields in the same cell. I campi First Name e Last Name vengono combinati nello stesso TemplateField oggetto.The first name and last name fields are combined into the same TemplateField object.


<%@ 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 utilizzata dai controlli con associazione a dati, GridView ad esempio DetailsViewe, per visualizzare il contenuto personalizzato per ogni record visualizzato.The TemplateField class is used by data-bound controls (such as GridView and DetailsView) to display custom content for each record displayed. Quando è necessario visualizzare il contenuto in un controllo con associazione a dati che non è fornito da uno dei campi di controllo dati predefiniti (ad esempio BoundField), usare la TemplateField classe per creare l'interfaccia utente personalizzata.When you need to display content in a data-bound control that is not provided by one of the predefined data control fields (such as BoundField), use the TemplateField class to create your custom user interface (UI). L' TemplateField oggetto viene visualizzato in modo diverso a seconda del controllo con associazione a dati in cui viene usato.The TemplateField object is displayed differently depending on the data-bound control in which it is used. Ad esempio, il GridView controllo Visualizza un TemplateField oggetto come colonna e il DetailsView controllo lo Visualizza come riga.For example, the GridView control displays a TemplateField object as a column, and the DetailsView control displays it as a row.

È possibile definire un modello personalizzato per le diverse parti dell' TemplateField oggetto utilizzando i modelli elencati nella tabella seguente.You can define a custom template for the different parts of the TemplateField object using the templates listed in the following table.

ModelloTemplate DescriptionDescription
AlternatingItemTemplate Specifica il contenuto da visualizzare per gli elementi alternativi in un TemplateField oggetto.Specifies the content to display for the alternating items in a TemplateField object.
EditItemTemplate Specifica il contenuto da visualizzare per un elemento in modalità di modifica in TemplateField un oggetto.Specifies the content to display for an item in edit mode in a TemplateField object.
FooterTemplate Specifica il contenuto da visualizzare per la sezione del piè di pagina TemplateField di un oggetto.Specifies the content to display for the footer section of a TemplateField object.
HeaderTemplate Specifica il contenuto da visualizzare per la sezione di intestazione di TemplateField un oggetto.Specifies the content to display for the header section of a TemplateField object.
InsertItemTemplate Specifica il contenuto da visualizzare per un elemento in modalità di inserimento in TemplateField un oggetto.Specifies the content to display for an item in insert mode in a TemplateField object. Questo modello è supportato solo dal DetailsView controllo.This template is supported only by the DetailsView control.
ItemTemplate Specifica il contenuto da visualizzare per gli elementi in un TemplateField oggetto.Specifies the content to display for the items in a TemplateField object.

È possibile nascondere un TemplateField oggetto in un controllo con associazione a dati impostando Visible la proprietà falsesu.You can hide a TemplateField object in a data-bound control by setting the Visible property to false.

In alternativa alla definizione di un modello HeaderTemplate o FooterTemplate personalizzato, è possibile personalizzare le sezioni dell'intestazione e del piè di TemplateField pagina di un oggetto impostando altre TemplateField proprietà dell'oggetto.As an alternative to defining a custom HeaderTemplate or FooterTemplate template, you can customize the header and footer sections of a TemplateField object by setting other properties of the TemplateField object. Per visualizzare una didascalia nelle sezioni dell'intestazione o del piè di pagina HeaderText , impostare FooterText rispettivamente la proprietà o.To display a caption in the header or footer sections, set the HeaderText or the FooterText property, respectively. Anziché visualizzare il testo nella sezione dell'intestazione, è possibile visualizzare un'immagine impostando la HeaderImageUrl proprietà.Instead of displaying text in the header section, you can display an image by setting the HeaderImageUrl property. La sezione dell'intestazione può essere nascosta nell' TemplateField oggetto impostando la ShowHeader proprietà su false.The header section can be hidden in the TemplateField object by setting the ShowHeader property to false.

Nota

Alcuni controlli associati a dati, ad esempio il GridView controllo, possono visualizzare o nascondere solo l'intera sezione di intestazione del controllo.Some data-bound controls (such as the GridView control) can show or hide only the entire header section of the control. Questi controlli associati a dati non supportano la ShowHeader proprietà per un singolo campo associato.These data-bound controls do not support the ShowHeader property for an individual bound field. Per visualizzare o nascondere l'intera sezione di intestazione di un controllo associato a dati, utilizzare la ShowHeader proprietà del controllo, se disponibile.To show or hide the entire header section of a data-bound control, use the control's ShowHeader property (if available).

È anche possibile personalizzare l'aspetto dell' TemplateField oggetto, ovvero il colore del carattere, il colore di sfondo e così via, impostando le proprietà di stile per le diverse parti del campo.You also can customize the appearance of the TemplateField object (font color, background color, and so on) by setting the style properties for the different parts of the field. Nella tabella seguente sono elencate le diverse proprietà di stile.The following table lists the different style properties.

Style (proprietà)Style property DescriptionDescription
ControlStyle Impostazioni di stile per i controlli del server Web figlio dell' TemplateField oggetto.The style settings for the child Web server controls of the TemplateField object.
FooterStyle Impostazioni di stile per la sezione del piè di pagina TemplateField dell'oggetto.The style settings for the footer section of the TemplateField object.
HeaderStyle Impostazioni di stile per la sezione di intestazione dell' TemplateField oggetto.The style settings for the header section of the TemplateField object.
ItemStyle Impostazioni di stile per gli elementi di dati nell' TemplateField oggetto.The style settings for the data items in the TemplateField object.

Costruttori

TemplateField() TemplateField() TemplateField() TemplateField()

Inizializza una nuova istanza della classe TemplateField.Initializes a new instance of the TemplateField class.

Proprietà

AccessibleHeaderText AccessibleHeaderText AccessibleHeaderText AccessibleHeaderText

Ottiene o imposta il testo che viene sottoposto a rendering come valore della proprietà AbbreviatedText in alcuni controlli.Gets or sets text that is rendered as the AbbreviatedText property value in some controls.

(Inherited from DataControlField)
AlternatingItemTemplate AlternatingItemTemplate AlternatingItemTemplate AlternatingItemTemplate

Ottiene o imposta il modello per visualizzare elementi alternativi in un oggetto TemplateField.Gets or sets the template for displaying the alternating items in a TemplateField object.

Control Control Control Control

Ottiene un riferimento al controllo dati a cui l'oggetto DataControlField è associato.Gets a reference to the data control that the DataControlField object is associated with.

(Inherited from DataControlField)
ControlStyle ControlStyle ControlStyle ControlStyle

Ottiene lo stile di tutti i controlli server Web contenuti nell'oggetto DataControlField.Gets the style of any Web server controls contained by the DataControlField object.

(Inherited from DataControlField)
ConvertEmptyStringToNull ConvertEmptyStringToNull ConvertEmptyStringToNull ConvertEmptyStringToNull

Ottiene o imposta un valore indicante se il valore a cui è associato l'oggetto TemplateField deve essere convertito in null se è Empty.Gets or sets a value indicating whether the value that the TemplateField object is bound to should be converted to null if it is Empty.

DesignMode DesignMode DesignMode DesignMode

Ottiene un valore che indica se un campo di controllo dati è attualmente visualizzato in un ambiente di progettazione.Gets a value indicating whether a data control field is currently viewed in a design-time environment.

(Inherited from DataControlField)
EditItemTemplate EditItemTemplate EditItemTemplate EditItemTemplate

Ottiene o imposta il modello per visualizzare un elemento in modalità di modifica in un oggetto TemplateField.Gets or sets the template for displaying an item in edit mode in a TemplateField object.

FooterStyle FooterStyle FooterStyle FooterStyle

Ottiene o imposta lo stile del piè di pagina del campo di controllo dati.Gets or sets the style of the footer of the data control field.

(Inherited from DataControlField)
FooterTemplate FooterTemplate FooterTemplate FooterTemplate

Ottiene o imposta il modello per visualizzare la sezione del piè di pagina di un oggetto TemplateField.Gets or sets the template for displaying the footer section of a TemplateField object.

FooterText FooterText FooterText FooterText

Ottiene o imposta il testo visualizzato nell'elemento del piè di pagina del campo di controllo dati.Gets or sets the text that is displayed in the footer item of a data control field.

(Inherited from DataControlField)
HeaderImageUrl HeaderImageUrl HeaderImageUrl HeaderImageUrl

Ottiene o imposta l'URL di un'immagine che viene visualizzata nell'elemento di intestazione di un campo di controlli dati.Gets or sets the URL of an image that is displayed in the header item of a data control field.

(Inherited from DataControlField)
HeaderStyle HeaderStyle HeaderStyle HeaderStyle

Ottiene o imposta lo stile dell'intestazione del campo di controllo dati.Gets or sets the style of the header of the data control field.

(Inherited from DataControlField)
HeaderTemplate HeaderTemplate HeaderTemplate HeaderTemplate

Ottiene o imposta il modello per visualizzare la sezione di intestazione di un oggetto TemplateField.Gets or sets the template for displaying the header section of a TemplateField object.

HeaderText HeaderText HeaderText HeaderText

Ottiene o imposta il testo visualizzato nell'elemento dell'intestazione di un campo di controllo dati.Gets or sets the text that is displayed in the header item of a data control field.

(Inherited from DataControlField)
IDataSourceViewSchemaAccessor.DataSourceViewSchema IDataSourceViewSchemaAccessor.DataSourceViewSchema IDataSourceViewSchemaAccessor.DataSourceViewSchema IDataSourceViewSchemaAccessor.DataSourceViewSchema

Ottiene o imposta lo schema associato all'oggetto DataControlField.Gets or sets the schema associated with this DataControlField object.

(Inherited from DataControlField)
InsertItemTemplate InsertItemTemplate InsertItemTemplate InsertItemTemplate

Ottiene o imposta il modello per visualizzare un elemento in modalità di inserimento in un oggetto TemplateField.Gets or sets the template for displaying an item in insert mode in a TemplateField object.

InsertVisible InsertVisible InsertVisible 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.Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode.

(Inherited from DataControlField)
IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate al relativo stato di visualizzazione.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Inherited from DataControlField)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate al relativo stato di visualizzazione.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Inherited from DataControlField)
ItemStyle ItemStyle ItemStyle ItemStyle

Ottiene lo stile di tutti i contenuti basati sul testo visualizzati da un campo di controllo dati.Gets the style of any text-based content displayed by a data control field.

(Inherited from DataControlField)
ItemTemplate ItemTemplate ItemTemplate ItemTemplate

Ottiene o imposta il modello per visualizzare un elemento in un controllo con associazione a dati.Gets or sets the template for displaying an item in a data-bound control.

ShowHeader ShowHeader ShowHeader ShowHeader

Ottiene o imposta un valore che indica se viene eseguito il rendering dell'elemento di intestazione di un campo di controllo dati.Gets or sets a value indicating whether the header item of a data control field is rendered.

(Inherited from DataControlField)
SortExpression SortExpression SortExpression SortExpression

Ottiene o imposta l'espressione di ordinamento che viene utilizzata da un controllo origine dati per ordinare i dati.Gets or sets a sort expression that is used by a data source control to sort data.

(Inherited from DataControlField)
ValidateRequestMode ValidateRequestMode ValidateRequestMode ValidateRequestMode

Ottiene o imposta un valore che specifica se il controllo convalida l'input del client.Gets or sets a value that specifies whether the control validates client input.

ViewState ViewState ViewState 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.Gets a dictionary of state information that allows you to save and restore the view state of a DataControlField object across multiple requests for the same page.

(Inherited from DataControlField)
Visible Visible Visible Visible

Ottiene o imposta un valore che indica se viene eseguito il rendering di un campo di controllo dati.Gets or sets a value indicating whether a data control field is rendered.

(Inherited from DataControlField)

Metodi

CloneField() CloneField() CloneField() CloneField()

Crea una copia duplicata dell'oggetto corrente derivato da DataControlField.Creates a duplicate copy of the current DataControlField-derived object.

(Inherited from DataControlField)
CopyProperties(DataControlField) CopyProperties(DataControlField) CopyProperties(DataControlField) CopyProperties(DataControlField)

Copia le proprietà dell'oggetto corrente derivato da TemplateField nell'oggetto DataControlField specificato.Copies the properties of the current TemplateField-derived object to the specified DataControlField object.

CreateField() CreateField() CreateField() CreateField()

Crea un nuovo oggetto TemplateField.Creates a new TemplateField object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) 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.Extracts the value of the data control fields as specified by one or more two-way binding statements (DataBind) from the current table cell and adds the values to the specified IOrderedDictionary collection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
Initialize(Boolean, Control) Initialize(Boolean, Control) Initialize(Boolean, Control) Initialize(Boolean, Control)

Esegue un'inizializzazione dell'istanza di base per un campo di controllo dati.Performs basic instance initialization for a data control field.

(Inherited from DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Aggiunge testo o controlli all'insieme dei controlli di una cella.Adds text or controls to a cell's controls collection.

LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

Ripristina lo stato di visualizzazione precedentemente salvato della visualizzazione origine dati.Restores the data source view's previously saved view state.

(Inherited from DataControlField)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
OnFieldChanged() OnFieldChanged() OnFieldChanged() OnFieldChanged()

Genera l'evento FieldChanged.Raises the FieldChanged event.

(Inherited from DataControlField)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

Salva le modifiche apportate allo stato di visualizzazione DataControlField dal momento in cui è stato eseguito il postback della pagina al server.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(Inherited from DataControlField)
ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta questo oggetto DataControlField.Returns a string that represents this DataControlField object.

(Inherited from DataControlField)
TrackViewState() TrackViewState() TrackViewState() 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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

(Inherited from DataControlField)
ValidateSupportsCallback() ValidateSupportsCallback() ValidateSupportsCallback() ValidateSupportsCallback()

Determina se i controlli contenuti in un oggetto TemplateField supportano i callback di pagina.Determines whether the controls contained in a TemplateField object support page callbacks.

Implementazioni dell'interfaccia esplicita

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

Ripristina lo stato di visualizzazione del campo del controllo dati salvato in precedenza.Restores the data control field's previously saved view state.

(Inherited from DataControlField)
IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

Salva le modifiche apportate allo stato di visualizzazione DataControlField dal momento in cui è stato eseguito il postback della pagina al server.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(Inherited from DataControlField)
IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() 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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

(Inherited from DataControlField)

Si applica a

Vedi anche