TemplateField TemplateField TemplateField TemplateField Class

Definition

Stellt ein Feld dar, das benutzerdefinierten Inhalt in einem datengebundenen Steuerelement anzeigt.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
Vererbung

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Benutzer TemplateField definiertes-Objekt erstellt wird, das zwei Felder in derselben Zelle anzeigt.The following code example demonstrates how to create a custom TemplateField object that displays two fields in the same cell. Die Felder "Vorname" und "Nachname" werden in demselben TemplateField Objekt kombiniert.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>

Hinweise

Die TemplateField -Klasse wird von Daten gebundenen Steuerelementen ( GridView z. b DetailsView. und) verwendet, um benutzerdefinierten Inhalt für jeden angezeigten Datensatz anzuzeigen.The TemplateField class is used by data-bound controls (such as GridView and DetailsView) to display custom content for each record displayed. Wenn Sie Inhalt in einem Daten gebundenen Steuerelement anzeigen müssen, das nicht von einem der vordefinierten Daten Steuerungs Felder (z BoundField. b.) bereitgestellt wird, verwenden Sie die-Klasse, um die TemplateField benutzerdefinierte Benutzeroberfläche (UI) zu erstellen.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). Das TemplateField Objekt wird unterschiedlich angezeigt, je nach dem Daten gebundenen Steuerelement, in dem es verwendet wird.The TemplateField object is displayed differently depending on the data-bound control in which it is used. Das GridView -Steuerelement zeigt z. TemplateField b. ein-Objekt als- DetailsView Spalte an, und das-Steuerelement zeigt es als Zeile an.For example, the GridView control displays a TemplateField object as a column, and the DetailsView control displays it as a row.

Mithilfe der in der folgenden Tabelle aufgeführten Vorlagen können Sie eine Benutzer TemplateField definierte Vorlage für die verschiedenen Teile des-Objekts definieren.You can define a custom template for the different parts of the TemplateField object using the templates listed in the following table.

VorlageTemplate BeschreibungDescription
AlternatingItemTemplate Gibt den Inhalt an, der für die abwechselnden Elemente TemplateField in einem-Objekt angezeigt werden soll.Specifies the content to display for the alternating items in a TemplateField object.
EditItemTemplate Gibt den Inhalt an, der für ein Element im Bearbeitungsmodus in TemplateField einem-Objekt angezeigt werden soll.Specifies the content to display for an item in edit mode in a TemplateField object.
FooterTemplate Gibt den Inhalt an, der für den Footerbereich eines TemplateField -Objekts angezeigt werden soll.Specifies the content to display for the footer section of a TemplateField object.
HeaderTemplate Gibt den Inhalt an, der für den Header Abschnitt eines TemplateField -Objekts angezeigt werden soll.Specifies the content to display for the header section of a TemplateField object.
InsertItemTemplate Gibt den Inhalt an, der für ein Element im Einfügemodus in einem TemplateField -Objekt angezeigt werden soll.Specifies the content to display for an item in insert mode in a TemplateField object. Diese Vorlage wird nur vom DetailsView -Steuerelement unterstützt.This template is supported only by the DetailsView control.
ItemTemplate Gibt den Inhalt an, der für die Elemente in TemplateField einem-Objekt angezeigt werden soll.Specifies the content to display for the items in a TemplateField object.

Sie können ein TemplateField -Objekt in einem Daten gebundenen Steuerelement ausblenden, indem Visible Sie die false-Eigenschaft auf festlegen.You can hide a TemplateField object in a data-bound control by setting the Visible property to false.

Als Alternative zum Definieren einer benutzerdefinierten HeaderTemplate Vorlage FooterTemplate oder einer Vorlage können Sie die Kopf-und TemplateField Fußzeilen Abschnitte eines-Objekts anpassen, indem Sie andere TemplateField Eigenschaften des-Objekts festlegen.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. Um eine Beschriftung in der Kopf- oder Fußzeile Abschnitten anzuzeigen, legen die HeaderText oder die FooterText Eigenschaft bzw.To display a caption in the header or footer sections, set the HeaderText or the FooterText property, respectively. Anstatt Text im Header Abschnitt anzuzeigen, können Sie ein Bild anzeigen, indem Sie die HeaderImageUrl -Eigenschaft festlegen.Instead of displaying text in the header section, you can display an image by setting the HeaderImageUrl property. Der Header Abschnitt kann im TemplateField -Objekt ausgeblendet werden, indem die ShowHeader -Eigenschaft auf falsefestgelegt wird.The header section can be hidden in the TemplateField object by setting the ShowHeader property to false.

Hinweis

Einige Daten gebundene Steuerelemente (z. b GridView . das-Steuerelement) können nur den gesamten Header Abschnitt des Steuer Elements anzeigen oder ausblenden.Some data-bound controls (such as the GridView control) can show or hide only the entire header section of the control. Diese Daten gebundenen Steuerelemente unterstützen die ShowHeader -Eigenschaft für ein einzelnes gebundenes Feld nicht.These data-bound controls do not support the ShowHeader property for an individual bound field. Um den gesamten Header Abschnitt eines Daten gebundenen Steuer Elements anzuzeigen oder auszublenden, verwenden Sie die- ShowHeader Eigenschaft des-Steuer Elements (falls verfügbar).To show or hide the entire header section of a data-bound control, use the control's ShowHeader property (if available).

Sie können auch die Darstellung des TemplateField Objekts (Schriftfarbe, Hintergrundfarbe usw.) anpassen, indem Sie die Stileigenschaften für die verschiedenen Teile des Felds festlegen.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. In der folgenden Tabelle werden die verschiedenen Stileigenschaften aufgelistet.The following table lists the different style properties.

Style-EigenschaftStyle property BeschreibungDescription
ControlStyle Die Stileinstellungen für die untergeordneten Webserver-Steuerelemente TemplateField des-Objekts.The style settings for the child Web server controls of the TemplateField object.
FooterStyle Die Stileinstellungen für den Footerbereich des TemplateField -Objekts.The style settings for the footer section of the TemplateField object.
HeaderStyle Die Stileinstellungen für den Header Abschnitt des TemplateField -Objekts.The style settings for the header section of the TemplateField object.
ItemStyle Die Stileinstellungen für die Datenelemente im TemplateField -Objekt.The style settings for the data items in the TemplateField object.

Konstruktoren

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

Initialisiert eine neue Instanz der TemplateField-Klasse.Initializes a new instance of the TemplateField class.

Eigenschaften

AccessibleHeaderText AccessibleHeaderText AccessibleHeaderText AccessibleHeaderText

Ruft Text ab, der in einigen Steuerelementen als AbbreviatedText-Eigenschaftswert gerendert wird, oder legt diesen fest.Gets or sets text that is rendered as the AbbreviatedText property value in some controls.

(Inherited from DataControlField)
AlternatingItemTemplate AlternatingItemTemplate AlternatingItemTemplate AlternatingItemTemplate

Ruft die Vorlage zum Anzeigen der abwechselnden Elemente in einem TemplateField-Objekt ab oder legt diese fest.Gets or sets the template for displaying the alternating items in a TemplateField object.

Control Control Control Control

Ruft einen Verweis auf das Datensteuerelement ab, dem das DataControlField-Objekt zugeordnet ist.Gets a reference to the data control that the DataControlField object is associated with.

(Inherited from DataControlField)
ControlStyle ControlStyle ControlStyle ControlStyle

Ruft den Stil aller im DataControlField-Objekt enthaltenen Webserver-Steuerelemente ab.Gets the style of any Web server controls contained by the DataControlField object.

(Inherited from DataControlField)
ConvertEmptyStringToNull ConvertEmptyStringToNull ConvertEmptyStringToNull ConvertEmptyStringToNull

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob der Wert, an den das TemplateField-Objekt gebunden ist, nach null konvertiert werden soll, wenn er Empty ist.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

Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld derzeit in einer Entwurfszeitumgebung angezeigt wird.Gets a value indicating whether a data control field is currently viewed in a design-time environment.

(Inherited from DataControlField)
EditItemTemplate EditItemTemplate EditItemTemplate EditItemTemplate

Ruft die Vorlage ab, mit der ein Element im Bearbeitungsmodus in einem TemplateField-Objekt angezeigt wird, oder legt diese Vorlage fest.Gets or sets the template for displaying an item in edit mode in a TemplateField object.

FooterStyle FooterStyle FooterStyle FooterStyle

Ruft den Stil der Fußzeile des Datensteuerelement-Felds ab oder legt diesen fest.Gets or sets the style of the footer of the data control field.

(Inherited from DataControlField)
FooterTemplate FooterTemplate FooterTemplate FooterTemplate

Ruft die Vorlage zum Anzeigen des Fußzeilenbereichs eines TemplateField-Objekts ab oder legt diese fest.Gets or sets the template for displaying the footer section of a TemplateField object.

FooterText FooterText FooterText FooterText

Ruft den Text ab, der im Fußzeilenelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diesen fest.Gets or sets the text that is displayed in the footer item of a data control field.

(Inherited from DataControlField)
HeaderImageUrl HeaderImageUrl HeaderImageUrl HeaderImageUrl

Ruft die URL zu einem Bild ab, das im Headerelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diese fest.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

Ruft den Stil des Headers des Datensteuerelement-Felds ab oder legt diesen fest.Gets or sets the style of the header of the data control field.

(Inherited from DataControlField)
HeaderTemplate HeaderTemplate HeaderTemplate HeaderTemplate

Ruft die Vorlage zum Anzeigen des Kopfzeilenbereichs eines TemplateField-Objekts ab oder legt diese fest.Gets or sets the template for displaying the header section of a TemplateField object.

HeaderText HeaderText HeaderText HeaderText

Ruft den Text ab, der im Headerelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diesen fest.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

Ruft das Schema ab, das diesem DataControlField-Objekt zugeordnet ist, oder legt es fest.Gets or sets the schema associated with this DataControlField object.

(Inherited from DataControlField)
InsertItemTemplate InsertItemTemplate InsertItemTemplate InsertItemTemplate

Ruft die Vorlage ab, mit der ein Element im Einfügemodus in einem TemplateField-Objekt angezeigt wird, oder legt diese Vorlage fest.Gets or sets the template for displaying an item in insert mode in a TemplateField object.

InsertVisible InsertVisible InsertVisible InsertVisible

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt angezeigt wird, wenn sich sein übergeordnetes datengebundenes Steuerelement im Einfügemodus befindet.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

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Inherited from DataControlField)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Inherited from DataControlField)
ItemStyle ItemStyle ItemStyle ItemStyle

Ruft das Format von allen textbasierten Inhalten ab, die von einem Datensteuerelement-Feld angezeigt werden.Gets the style of any text-based content displayed by a data control field.

(Inherited from DataControlField)
ItemTemplate ItemTemplate ItemTemplate ItemTemplate

Ruft die Vorlage ab, mit der ein Element in einem datengebundenen Steuerelement angezeigt wird, oder legt diese fest.Gets or sets the template for displaying an item in a data-bound control.

ShowHeader ShowHeader ShowHeader ShowHeader

Ruft einen Wert ab, der angibt, ob das Headerelement eines Datensteuerelementfelds gerendert wird, oder legt diesen fest.Gets or sets a value indicating whether the header item of a data control field is rendered.

(Inherited from DataControlField)
SortExpression SortExpression SortExpression SortExpression

Ruft einen Sortierausdruck ab, mit dem ein Datenquellen-Steuerelement Daten sortiert, oder legt diesen fest.Gets or sets a sort expression that is used by a data source control to sort data.

(Inherited from DataControlField)
ValidateRequestMode ValidateRequestMode ValidateRequestMode ValidateRequestMode

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben überprüft.Gets or sets a value that specifies whether the control validates client input.

ViewState ViewState ViewState ViewState

Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines DataControlField-Objekts über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können.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

Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld dargestellt werden soll, oder legt diesen fest.Gets or sets a value indicating whether a data control field is rendered.

(Inherited from DataControlField)

Methoden

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

Erstellt eine doppelte Kopie des aktuellen, von DataControlField abgeleiteten Objekts.Creates a duplicate copy of the current DataControlField-derived object.

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

Kopiert die Eigenschaften des aktuellen, aus TemplateField abgeleiteten Objekts in das angegebene DataControlField-Objekt.Copies the properties of the current TemplateField-derived object to the specified DataControlField object.

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

Erstellt ein neues TemplateField-Objekt.Creates a new TemplateField object.

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

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.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)

Extrahiert gemäß den Angaben durch eine oder mehrere Anweisungen zur bidirektionalen Datenbindung (DataBind) die Werte der Datensteuerelementfelder aus der aktuellen Tabellenzelle und fügt diese Werte der angegebenen IOrderedDictionary-Auflistung hinzu.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()

Fungiert als Standardhashfunktion.Serves as the default hash function.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Führt eine grundlegende Instanzinitialisierung für ein Datensteuerelement-Feld aus.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)

Fügt der Steuerelementauflistung einer Zelle Text oder Steuerelemente hinzu.Adds text or controls to a cell's controls collection.

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

Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her.Restores the data source view's previously saved view state.

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

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Löst das FieldChanged-Ereignis aus.Raises the FieldChanged event.

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

Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde.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()

Gibt eine Zeichenfolge zurück, die dieses DataControlField-Objekt darstellt.Returns a string that represents this DataControlField object.

(Inherited from DataControlField)
TrackViewState() TrackViewState() TrackViewState() TrackViewState()

Bewirkt, dass das DataControlField-Objekt Änderungen an seinem Ansichtszustand nachverfolgt, damit diese in der ViewState-Eigenschaft des Steuerelements gespeichert und über mehrere Anforderungen für dieselbe Seite hinweg beibehalten werden.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()

Bestimmt, ob die in einem TemplateField-Objekt enthaltenen Steuerelemente Seitenrückrufe unterstützen.Determines whether the controls contained in a TemplateField object support page callbacks.

Explizite Schnittstellenimplementierungen

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

Stellt den zuvor gespeicherten Ansichtszustand des Datensteuerelement-Felds wieder her.Restores the data control field's previously saved view state.

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

Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde.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()

Bewirkt, dass das DataControlField-Objekt Änderungen an seinem Ansichtszustand nachverfolgt, damit diese in der ViewState-Eigenschaft des Steuerelements gespeichert und über mehrere Anforderungen für dieselbe Seite hinweg beibehalten werden.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)

Gilt für:

Siehe auch