TemplateField Klasse

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

DataControlField
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:

Freigeben über