Freigeben über


TemplateField Klasse

Definition

Stellt ein Feld dar, das benutzerdefinierten Inhalt in einem datengebundenen Steuerelement anzeigt.

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
TemplateField

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein benutzerdefiniertes TemplateField Objekt erstellt wird, das zwei Felder in derselben Zelle anzeigt. Die Felder Vor- und Nachname werden in demselben TemplateField Objekt kombiniert.


<%@ 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 datengebundenen Steuerelementen (z GridView . B. und DetailsView) verwendet, um benutzerdefinierte Inhalte für jeden angezeigten Datensatz anzuzeigen. Wenn Sie Inhalte in einem datengebundenen Steuerelement anzeigen müssen, das nicht von einem der vordefinierten Datensteuerelementfelder (z BoundField. B. ) bereitgestellt wird, verwenden Sie die TemplateField -Klasse, um Ihre benutzerdefinierte Benutzeroberfläche (UI) zu erstellen. Das TemplateField Objekt wird je nach datengebundenem Steuerelement, in dem es verwendet wird, unterschiedlich angezeigt. Das Steuerelement zeigt beispielsweise GridView ein TemplateField Objekt als Spalte an, und das DetailsView Steuerelement zeigt es als Zeile an.

Sie können eine benutzerdefinierte Vorlage für die verschiedenen Teile des Objekts mithilfe der TemplateField in der folgenden Tabelle aufgeführten Vorlagen definieren.

Vorlage BESCHREIBUNG
AlternatingItemTemplate Gibt den Inhalt an, der für die wechselnden Elemente in einem TemplateField -Objekt angezeigt werden soll.
EditItemTemplate Gibt den Inhalt an, der für ein Element im Bearbeitungsmodus in einem TemplateField -Objekt angezeigt werden soll.
FooterTemplate Gibt den Inhalt an, der für den Fußzeilenabschnitt eines TemplateField Objekts angezeigt werden soll.
HeaderTemplate Gibt den Inhalt an, der für den Headerabschnitt eines TemplateField Objekts angezeigt werden soll.
InsertItemTemplate Gibt den Inhalt an, der für ein Element im Einfügemodus in einem TemplateField -Objekt angezeigt werden soll. Diese Vorlage wird nur vom DetailsView Steuerelement unterstützt.
ItemTemplate Gibt den Inhalt an, der für die Elemente in einem TemplateField -Objekt angezeigt werden soll.

Sie können ein TemplateField Objekt in einem datengebundenen Steuerelement ausblenden, indem Sie die Visible -Eigenschaft auf falsefestlegen.

Alternativ zum Definieren einer benutzerdefinierten HeaderTemplate Vorlage FooterTemplate können Sie die Kopf- und Fußzeilenabschnitte eines TemplateField Objekts anpassen, indem Sie andere Eigenschaften des TemplateField Objekts festlegen. Um eine Beschriftung in der Kopf- oder Fußzeile Abschnitten anzuzeigen, legen die HeaderText oder die FooterText Eigenschaft bzw. Anstatt Text im Kopfzeilenabschnitt anzuzeigen, können Sie ein Bild anzeigen, indem Sie die HeaderImageUrl -Eigenschaft festlegen. Der Headerabschnitt kann im TemplateField -Objekt ausgeblendet werden, indem Sie die ShowHeader -Eigenschaft auf falsefestlegen.

Hinweis

Einige datengebundene Steuerelemente (z. B. das GridView -Steuerelement) können nur den gesamten Headerabschnitt des Steuerelements ein- oder ausblenden. Diese datengebundenen Steuerelemente unterstützen die ShowHeader -Eigenschaft für ein einzelnes gebundenes Feld nicht. Um den gesamten Headerabschnitt eines datengebundenen Steuerelements ein- oder auszublenden, verwenden Sie die -Eigenschaft des Steuerelements ShowHeader (sofern verfügbar).

Sie können auch die Darstellung des TemplateField Objekts anpassen (Schriftfarbe, Hintergrundfarbe usw.), indem Sie die Formateigenschaften für die verschiedenen Teile des Felds festlegen. In der folgenden Tabelle sind die verschiedenen Stileigenschaften aufgeführt.

Style-Eigenschaft BESCHREIBUNG
ControlStyle Die Stileinstellungen für die untergeordneten Webserversteuerelemente des TemplateField Objekts.
FooterStyle Die Formateinstellungen für den Fußzeilenabschnitt des TemplateField Objekts.
HeaderStyle Die Formateinstellungen für den Headerabschnitt des TemplateField -Objekts.
ItemStyle Die Stileinstellungen für die Datenelemente im TemplateField -Objekt.

Konstruktoren

TemplateField()

Initialisiert eine neue Instanz der TemplateField-Klasse.

Eigenschaften

AccessibleHeaderText

Ruft Text ab, der in einigen Steuerelementen als AbbreviatedText-Eigenschaftswert gerendert wird, oder legt diesen fest.

(Geerbt von DataControlField)
AlternatingItemTemplate

Ruft die Vorlage zum Anzeigen der abwechselnden Elemente in einem TemplateField-Objekt ab oder legt diese fest.

Control

Ruft einen Verweis auf das Datensteuerelement ab, dem das DataControlField-Objekt zugeordnet ist.

(Geerbt von DataControlField)
ControlStyle

Ruft den Stil aller im DataControlField-Objekt enthaltenen Webserver-Steuerelemente ab.

(Geerbt von DataControlField)
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.

DesignMode

Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld derzeit in einer Entwurfszeitumgebung angezeigt wird.

(Geerbt von DataControlField)
EditItemTemplate

Ruft die Vorlage ab, mit der ein Element im Bearbeitungsmodus in einem TemplateField-Objekt angezeigt wird, oder legt diese Vorlage fest.

FooterStyle

Ruft den Stil der Fußzeile des Datensteuerelement-Felds ab oder legt diesen fest.

(Geerbt von DataControlField)
FooterTemplate

Ruft die Vorlage zum Anzeigen des Fußzeilenbereichs eines TemplateField-Objekts ab oder legt diese fest.

FooterText

Ruft den Text ab, der im Fußzeilenelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diesen fest.

(Geerbt von DataControlField)
HeaderImageUrl

Ruft die URL zu einem Bild ab, das im Headerelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diese fest.

(Geerbt von DataControlField)
HeaderStyle

Ruft den Stil des Headers des Datensteuerelement-Felds ab oder legt diesen fest.

(Geerbt von DataControlField)
HeaderTemplate

Ruft die Vorlage zum Anzeigen des Kopfzeilenbereichs eines TemplateField-Objekts ab oder legt diese fest.

HeaderText

Ruft den Text ab, der im Headerelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diesen fest.

(Geerbt von DataControlField)
InsertItemTemplate

Ruft die Vorlage ab, mit der ein Element im Einfügemodus in einem TemplateField-Objekt angezeigt wird, oder legt diese Vorlage fest.

InsertVisible

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt angezeigt wird, wenn sich sein übergeordnetes datengebundenes Steuerelement im Einfügemodus befindet.

(Geerbt von DataControlField)
IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert.

(Geerbt von DataControlField)
ItemStyle

Ruft das Format von allen textbasierten Inhalten ab, die von einem Datensteuerelement-Feld angezeigt werden.

(Geerbt von DataControlField)
ItemTemplate

Ruft die Vorlage ab, mit der ein Element in einem datengebundenen Steuerelement angezeigt wird, oder legt diese fest.

ShowHeader

Ruft einen Wert ab, der angibt, ob das Headerelement eines Datensteuerelementfelds gerendert wird, oder legt diesen fest.

(Geerbt von DataControlField)
SortExpression

Ruft einen Sortierausdruck ab, mit dem ein Datenquellen-Steuerelement Daten sortiert, oder legt diesen fest.

(Geerbt von DataControlField)
ValidateRequestMode

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben überprüft.

ValidateRequestMode

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben überprüft.

(Geerbt von DataControlField)
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.

(Geerbt von DataControlField)
Visible

Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld dargestellt werden soll, oder legt diesen fest.

(Geerbt von DataControlField)

Methoden

CloneField()

Erstellt eine doppelte Kopie des aktuellen, von DataControlField abgeleiteten Objekts.

(Geerbt von DataControlField)
CopyProperties(DataControlField)

Kopiert die Eigenschaften des aktuellen, aus TemplateField abgeleiteten Objekts in das angegebene DataControlField-Objekt.

CreateField()

Erstellt ein neues TemplateField-Objekt.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
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.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
Initialize(Boolean, Control)

Führt eine grundlegende Instanzinitialisierung für ein Datensteuerelement-Feld aus.

(Geerbt von DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Fügt der Steuerelementauflistung einer Zelle Text oder Steuerelemente hinzu.

LoadViewState(Object)

Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her.

(Geerbt von DataControlField)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
OnFieldChanged()

Löst das FieldChanged-Ereignis aus.

(Geerbt von DataControlField)
SaveViewState()

Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde.

(Geerbt von DataControlField)
ToString()

Gibt eine Zeichenfolge zurück, die dieses DataControlField-Objekt darstellt.

(Geerbt von DataControlField)
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.

(Geerbt von DataControlField)
ValidateSupportsCallback()

Bestimmt, ob die in einem TemplateField-Objekt enthaltenen Steuerelemente Seitenrückrufe unterstützen.

Explizite Schnittstellenimplementierungen

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Ruft das Schema ab, das diesem DataControlField-Objekt zugeordnet ist, oder legt es fest.

(Geerbt von DataControlField)
IStateManager.IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert.

(Geerbt von DataControlField)
IStateManager.LoadViewState(Object)

Stellt den zuvor gespeicherten Ansichtszustand des Datensteuerelement-Felds wieder her.

(Geerbt von DataControlField)
IStateManager.SaveViewState()

Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde.

(Geerbt von DataControlField)
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.

(Geerbt von DataControlField)

Gilt für:

Weitere Informationen