TemplateField Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Reprezentuje pole, które wyświetla zawartość niestandardową w kontrolce powiązanej z danymi.

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

Dziedziczenie: Object

DataControlField
TemplateField

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć obiekt niestandardowy TemplateField , który wyświetla dwa pola w tej samej komórce. Pola imię i nazwisko są łączone w ten sam TemplateField obiekt.


<%@ 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>

Uwagi

Klasa TemplateField jest używana przez kontrolki powiązane z danymi (takie jak GridView i DetailsView) do wyświetlania zawartości niestandardowej dla każdego wyświetlanego rekordu. Gdy musisz wyświetlić zawartość w kontrolce powiązanej z danymi, która nie jest dostarczana przez jedno ze wstępnie zdefiniowanych pól kontroli danych (na przykład BoundField), użyj TemplateField klasy do utworzenia niestandardowego interfejsu użytkownika. Obiekt TemplateField jest wyświetlany inaczej w zależności od kontrolki powiązanej z danymi, w której jest używana. Na przykład kontrolka GridView wyświetla obiekt jako kolumnę TemplateField , a kontrolka DetailsView wyświetla ją jako wiersz.

Szablon niestandardowy dla różnych części TemplateField obiektu można zdefiniować przy użyciu szablonów wymienionych w poniższej tabeli.

Template	Opis
AlternatingItemTemplate	Określa zawartość, która ma być wyświetlana dla elementów przemiennych w TemplateField obiekcie.
EditItemTemplate	Określa zawartość, która ma być wyświetlana dla elementu w trybie edycji w TemplateField obiekcie.
FooterTemplate	Określa zawartość, która ma być wyświetlana dla sekcji stopki TemplateField obiektu.
HeaderTemplate	Określa zawartość do wyświetlenia dla sekcji nagłówka TemplateField obiektu.
InsertItemTemplate	Określa zawartość, która ma być wyświetlana dla elementu w trybie TemplateField wstawiania w obiekcie. Ten szablon jest obsługiwany tylko przez kontrolkę DetailsView .
ItemTemplate	Określa zawartość, która ma być wyświetlana dla elementów w TemplateField obiekcie.

Obiekt można ukryć TemplateField w kontrolce powiązanej z danymi, ustawiając Visible właściwość na false.

Alternatywą dla definiowania niestandardowego HeaderTemplate lub FooterTemplate szablonu jest dostosowanie sekcji TemplateField nagłówka i stopki obiektu przez ustawienie innych właściwości TemplateField obiektu. Aby wyświetlić podpis w sekcjach nagłówka lub stopki, ustaw HeaderText odpowiednio właściwość lubFooterText. Zamiast wyświetlać tekst w sekcji nagłówka, możesz wyświetlić obraz, ustawiając HeaderImageUrl właściwość. Sekcja nagłówka może być ukryta TemplateField w obiekcie, ustawiając ShowHeader właściwość na false.

Uwaga

Niektóre kontrolki powiązane z danymi (takie jak kontrolka GridView ) mogą wyświetlać lub ukrywać tylko całą sekcję nagłówka kontrolki. Te kontrolki powiązane z danymi nie obsługują ShowHeader właściwości dla pojedynczego pola powiązanego. Aby wyświetlić lub ukryć całą sekcję nagłówka kontrolki powiązanej z danymi, użyj właściwości kontrolki ShowHeader (jeśli jest dostępna).

Możesz również dostosować wygląd TemplateField obiektu (kolor czcionki, kolor tła itd.), ustawiając właściwości stylu dla różnych części pola. W poniższej tabeli wymieniono różne właściwości stylu.

Właściwość Stylu	Opis
ControlStyle	Ustawienia stylu podrzędnego serwera sieci Web steruje obiektem TemplateField .
FooterStyle	Ustawienia stylu sekcji TemplateField stopki obiektu.
HeaderStyle	Ustawienia stylu sekcji nagłówka TemplateField obiektu.
ItemStyle	Ustawienia stylu elementów danych w TemplateField obiekcie.

Konstruktory

TemplateField()

Inicjuje nowe wystąpienie klasy TemplateField.

Właściwości

AccessibleHeaderText	Pobiera lub ustawia tekst renderowany jako `AbbreviatedText` wartość właściwości w niektórych kontrolkach. (Odziedziczone po DataControlField)
AlternatingItemTemplate	Pobiera lub ustawia szablon do wyświetlania elementów przemiennych w TemplateField obiekcie.
Control	Pobiera odwołanie do kontrolki danych skojarzonej DataControlField z obiektem. (Odziedziczone po DataControlField)
ControlStyle	Pobiera styl wszystkich kontrolek serwera sieci Web zawartych w DataControlField obiekcie. (Odziedziczone po DataControlField)
ConvertEmptyStringToNull	Pobiera lub ustawia wartość wskazującą, TemplateField czy wartość, którą obiekt jest powiązany, powinna zostać przekonwertowana na `null` wartość , jeśli jest Emptyto .
DesignMode	Pobiera wartość wskazującą, czy pole kontrolki danych jest obecnie wyświetlane w środowisku czasu projektowania. (Odziedziczone po DataControlField)
EditItemTemplate	Pobiera lub ustawia szablon do wyświetlania elementu w trybie edycji w TemplateField obiekcie.
FooterStyle	Pobiera lub ustawia styl stopki pola kontrolki danych. (Odziedziczone po DataControlField)
FooterTemplate	Pobiera lub ustawia szablon do wyświetlania sekcji stopki TemplateField obiektu.
FooterText	Pobiera lub ustawia tekst wyświetlany w elemencie stopki pola kontrolki danych. (Odziedziczone po DataControlField)
HeaderImageUrl	Pobiera lub ustawia adres URL obrazu wyświetlanego w elemencie nagłówka pola kontrolki danych. (Odziedziczone po DataControlField)
HeaderStyle	Pobiera lub ustawia styl nagłówka pola kontrolki danych. (Odziedziczone po DataControlField)
HeaderTemplate	Pobiera lub ustawia szablon do wyświetlania sekcji nagłówka TemplateField obiektu.
HeaderText	Pobiera lub ustawia tekst wyświetlany w elemencie nagłówka pola kontrolki danych. (Odziedziczone po DataControlField)
InsertItemTemplate	Pobiera lub ustawia szablon do wyświetlania elementu w trybie TemplateField wstawiania w obiekcie.
InsertVisible	Pobiera wartość wskazującą, czy DataControlField obiekt jest widoczny, gdy jego nadrzędna kontrolka powiązana z danymi jest w trybie wstawiania. (Odziedziczone po DataControlField)
IsTrackingViewState	Pobiera wartość wskazującą, czy DataControlField obiekt zapisuje zmiany w stanie widoku. (Odziedziczone po DataControlField)
ItemStyle	Pobiera styl dowolnej zawartości tekstowej wyświetlanej przez pole kontrolki danych. (Odziedziczone po DataControlField)
ItemTemplate	Pobiera lub ustawia szablon do wyświetlania elementu w kontrolce powiązanej z danymi.
ShowHeader	Pobiera lub ustawia wartość wskazującą, czy element nagłówka pola kontrolki danych jest renderowany. (Odziedziczone po DataControlField)
SortExpression	Pobiera lub ustawia wyrażenie sortowania, które jest używane przez kontrolkę źródła danych do sortowania danych. (Odziedziczone po DataControlField)
ValidateRequestMode	Pobiera lub ustawia wartość określającą, czy kontrolka weryfikuje dane wejściowe klienta.
ValidateRequestMode	Pobiera lub ustawia wartość określającą, czy kontrolka weryfikuje dane wejściowe klienta. (Odziedziczone po DataControlField)
ViewState	Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu DataControlField widoku obiektu na wielu żądaniach dla tej samej strony. (Odziedziczone po DataControlField)
Visible	Pobiera lub ustawia wartość wskazującą, czy pole kontrolki danych jest renderowane. (Odziedziczone po DataControlField)

Metody

CloneField()	Tworzy zduplikowaną kopię bieżącego DataControlFieldobiektu pochodnego. (Odziedziczone po DataControlField)
CopyProperties(DataControlField)	Kopiuje właściwości bieżącego TemplateFieldobiektu pochodnego do określonego DataControlField obiektu.
CreateField()	Tworzy nowy TemplateField obiekt.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Wyodrębnia wartość pól kontroli danych określonych przez co najmniej jedną instrukcję powiązania dwukierunkowego (`DataBind`) z bieżącej komórki tabeli i dodaje wartości do określonej IOrderedDictionary kolekcji.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
Initialize(Boolean, Control)	Wykonuje inicjowanie podstawowego wystąpienia dla pola kontroli danych. (Odziedziczone po DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Dodaje tekst lub kontrolki do kolekcji kontrolek komórki.
LoadViewState(Object)	Przywraca wcześniej zapisany stan widoku źródła danych. (Odziedziczone po DataControlField)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnFieldChanged()	`FieldChanged` Zgłasza zdarzenie. (Odziedziczone po DataControlField)
SaveViewState()	Zapisuje zmiany wprowadzone w DataControlField stanie widoku od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po DataControlField)
ToString()	Zwraca ciąg reprezentujący ten DataControlField obiekt. (Odziedziczone po DataControlField)
TrackViewState()	DataControlField Powoduje, że obiekt będzie śledzić zmiany w stanie widoku, dzięki czemu można je przechowywać we właściwości kontrolki ViewState i utrwalać w żądaniach dla tej samej strony. (Odziedziczone po DataControlField)
ValidateSupportsCallback()	Określa, czy kontrolki zawarte w TemplateField wywołaniach zwrotnych strony obsługi obiektu.

Jawne implementacje interfejsu

IDataSourceViewSchemaAccessor.DataSourceViewSchema	Pobiera lub ustawia schemat skojarzony z tym DataControlField obiektem. (Odziedziczone po DataControlField)
IStateManager.IsTrackingViewState	Pobiera wartość wskazującą, czy DataControlField obiekt zapisuje zmiany w stanie widoku. (Odziedziczone po DataControlField)
IStateManager.LoadViewState(Object)	Przywraca wcześniej zapisany stan widoku pola kontroli danych. (Odziedziczone po DataControlField)
IStateManager.SaveViewState()	Zapisuje zmiany wprowadzone w DataControlField stanie widoku od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po DataControlField)
IStateManager.TrackViewState()	DataControlField Powoduje, że obiekt będzie śledzić zmiany w stanie widoku, dzięki czemu można je przechowywać we właściwości kontrolki ViewState i utrwalać w żądaniach dla tej samej strony. (Odziedziczone po DataControlField)

Dotyczy