Sdílet prostřednictvím


TemplateField Třída

Definice

Představuje pole, které zobrazuje vlastní obsah v ovládacím prvku vázaném na data.

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
Dědičnost
TemplateField

Příklady

Následující příklad kódu ukazuje, jak vytvořit vlastní TemplateField objekt, který zobrazí dvě pole ve stejné buňce. Pole jméno a příjmení se zkombinují do stejného TemplateField objektu.


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

Poznámky

Třídu TemplateField používají ovládací prvky vázané na data (například GridView a DetailsView) k zobrazení vlastního obsahu pro každý zobrazený záznam. Pokud potřebujete zobrazit obsah v ovládacím prvku vázaném na data, který není poskytován jedním z předdefinovaných polí ovládacího prvku dat (například BoundField), použijte k vytvoření vlastního TemplateField uživatelského rozhraní třídu . Objekt TemplateField se zobrazí různě v závislosti na ovládacím prvku vázaném na data, ve kterém se používá. Ovládací prvek například GridView zobrazí TemplateField objekt jako sloupec a ovládací prvek ho DetailsView zobrazí jako řádek.

Vlastní šablonu můžete definovat pro různé části objektu TemplateField pomocí šablon uvedených v následující tabulce.

Template (Šablona) Description
AlternatingItemTemplate Určuje obsah, který se má zobrazit pro střídavé položky v objektu TemplateField .
EditItemTemplate Určuje obsah, který se má zobrazit pro položku v režimu úprav v objektu TemplateField .
FooterTemplate Určuje obsah, který se má zobrazit v části zápatí objektu TemplateField .
HeaderTemplate Určuje obsah, který se má zobrazit v oddílu záhlaví objektu TemplateField .
InsertItemTemplate Určuje obsah, který se má zobrazit pro položku v režimu vkládání v objektu TemplateField . Tuto šablonu podporuje pouze DetailsView ovládací prvek.
ItemTemplate Určuje obsah, který se má zobrazit pro položky v objektu TemplateField .

Objekt v ovládacím prvku vázaném TemplateField na data můžete skrýt nastavením Visible vlastnosti na false.

Jako alternativu k definování vlastního HeaderTemplate objektu nebo FooterTemplate šablony můžete přizpůsobit oddíly záhlaví a zápatí objektu TemplateField nastavením dalších vlastností objektu TemplateField . Pokud chcete zobrazit popis v oddílech záhlaví nebo zápatí, nastavte HeaderText vlastnost nebo FooterText (v uvedeném pořadí). Místo zobrazení textu v oddílu záhlaví můžete zobrazit obrázek nastavením HeaderImageUrl vlastnosti . Oddíl záhlaví lze v objektu TemplateField skrýt nastavením ShowHeader vlastnosti na false.

Poznámka

Některé ovládací prvky vázané na data (například GridView ovládací prvek) mohou zobrazit nebo skrýt pouze celou část záhlaví ovládacího prvku. Tyto ovládací prvky vázané na ShowHeader data nepodporují vlastnost pro jednotlivé vázané pole. Pokud chcete zobrazit nebo skrýt celou část záhlaví ovládacího prvku vázaného na data, použijte vlastnost ovládacího prvku ShowHeader (pokud je k dispozici).

Můžete také přizpůsobit vzhled objektu TemplateField (barvu písma, barvu pozadí atd.) nastavením vlastností stylu pro různé části pole. V následující tabulce jsou uvedeny různé vlastnosti stylu.

Vlastnost Style Description
ControlStyle Nastavení stylu podřízeného webového serveru ovládací prvky objektu TemplateField .
FooterStyle Nastavení stylu pro část zápatí objektu TemplateField .
HeaderStyle Nastavení stylu pro oddíl záhlaví objektu TemplateField .
ItemStyle Nastavení stylu pro datové položky v objektu TemplateField .

Konstruktory

TemplateField()

Inicializuje novou instanci TemplateField třídy .

Vlastnosti

AccessibleHeaderText

Získá nebo nastaví text, který je vykreslen jako AbbreviatedText hodnota vlastnosti v některých ovládacích prvcích.

(Zděděno od DataControlField)
AlternatingItemTemplate

Získá nebo nastaví šablonu pro zobrazení střídavých položek v objektu TemplateField .

Control

Získá odkaz na ovládací prvek dat, ke kterému DataControlField je objekt přidružen.

(Zděděno od DataControlField)
ControlStyle

Získá styl všech ovládacích prvků webového serveru obsažených v objektu DataControlField .

(Zděděno od DataControlField)
ConvertEmptyStringToNull

Získá nebo nastaví hodnotu označující, zda má být hodnota, se kterou TemplateField je objekt vázán, převedena na null , pokud je Empty.

DesignMode

Získá hodnotu označující, zda je pole řízení dat aktuálně zobrazena v prostředí návrhu.

(Zděděno od DataControlField)
EditItemTemplate

Získá nebo nastaví šablonu pro zobrazení položky v režimu úprav v objektu TemplateField .

FooterStyle

Získá nebo nastaví styl zápatí pole ovládacího prvku dat.

(Zděděno od DataControlField)
FooterTemplate

Získá nebo nastaví šablonu pro zobrazení zápatí oddílu objektu TemplateField .

FooterText

Získá nebo nastaví text, který je zobrazen v zápatí pole ovládacího prvku dat.

(Zděděno od DataControlField)
HeaderImageUrl

Získá nebo nastaví adresu URL obrázku, který se zobrazí v položce záhlaví pole ovládacího prvku dat.

(Zděděno od DataControlField)
HeaderStyle

Získá nebo nastaví styl záhlaví pole ovládacího prvku dat.

(Zděděno od DataControlField)
HeaderTemplate

Získá nebo nastaví šablonu pro zobrazení záhlaví oddílu objektu TemplateField .

HeaderText

Získá nebo nastaví text, který je zobrazen v záhlaví pole ovládacího prvku dat.

(Zděděno od DataControlField)
InsertItemTemplate

Získá nebo nastaví šablonu pro zobrazení položky v režimu vložení v objektu TemplateField .

InsertVisible

Získá hodnotu označující, zda DataControlField objekt je viditelný, když jeho nadřazený ovládací prvek vázané na data je v režimu vložení.

(Zděděno od DataControlField)
IsTrackingViewState

Získá hodnotu označující, zda DataControlField objekt ukládá změny do stavu zobrazení.

(Zděděno od DataControlField)
ItemStyle

Získá styl libovolného textového obsahu zobrazeného polem ovládacího prvku dat.

(Zděděno od DataControlField)
ItemTemplate

Získá nebo nastaví šablonu pro zobrazení položky v ovládacím prvku vázaném na data.

ShowHeader

Získá nebo nastaví hodnotu označující, zda je vykreslena položka záhlaví pole ovládacího prvku dat.

(Zděděno od DataControlField)
SortExpression

Získá nebo nastaví výraz řazení, který se používá ovládací prvek zdroje dat k řazení dat.

(Zděděno od DataControlField)
ValidateRequestMode

Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek ověřuje vstup klienta.

ValidateRequestMode

Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek ověřuje vstup klienta.

(Zděděno od DataControlField)
ViewState

Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení objektu DataControlField v rámci více požadavků na stejnou stránku.

(Zděděno od DataControlField)
Visible

Získá nebo nastaví hodnotu označující, zda je pole ovládacího prvku dat vykresleno.

(Zděděno od DataControlField)

Metody

CloneField()

Vytvoří duplicitní kopii aktuálního DataControlFieldodvozeného objektu.

(Zděděno od DataControlField)
CopyProperties(DataControlField)

Zkopíruje vlastnosti aktuálního TemplateFieldodvozeného objektu do zadaného DataControlField objektu.

CreateField()

Vytvoří nový TemplateField objekt.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Extrahuje hodnotu polí ovládacího prvku dat určených jedním nebo více příkazy obousměrné vazby (DataBind) z aktuální buňky tabulky a přidá hodnoty do zadané IOrderedDictionary kolekce.

GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetType()

Type Získá z aktuální instance.

(Zděděno od Object)
Initialize(Boolean, Control)

Provede základní inicializaci instance pro pole ovládacího prvku dat.

(Zděděno od DataControlField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Přidá text nebo ovládací prvky do kolekce ovládacích prvků buňky.

LoadViewState(Object)

Obnoví dříve uložený stav zobrazení zdroje dat.

(Zděděno od DataControlField)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
OnFieldChanged()

FieldChanged Vyvolá událost.

(Zděděno od DataControlField)
SaveViewState()

Uloží změny provedené ve DataControlField stavu zobrazení od okamžiku, kdy byla stránka odeslána zpět na server.

(Zděděno od DataControlField)
ToString()

Vrátí řetězec, který představuje tento DataControlField objekt.

(Zděděno od DataControlField)
TrackViewState()

Způsobí, že DataControlField objekt bude sledovat změny stavu zobrazení, aby je bylo možné uložit ve vlastnosti ovládacího prvku ViewState a zachovat v požadavcích na stejnou stránku.

(Zděděno od DataControlField)
ValidateSupportsCallback()

Určuje, zda ovládací prvky obsažené v objektu TemplateField podporují zpětná volání stránky.

Explicitní implementace rozhraní

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Získá nebo nastaví schéma přidružené k tomuto DataControlField objektu.

(Zděděno od DataControlField)
IStateManager.IsTrackingViewState

Získá hodnotu označující, zda DataControlField objekt ukládá změny do stavu zobrazení.

(Zděděno od DataControlField)
IStateManager.LoadViewState(Object)

Obnoví dříve uložený stav zobrazení pole ovládacího prvku dat.

(Zděděno od DataControlField)
IStateManager.SaveViewState()

Uloží změny provedené ve DataControlField stavu zobrazení od okamžiku, kdy byla stránka odeslána zpět na server.

(Zděděno od DataControlField)
IStateManager.TrackViewState()

Způsobí, že DataControlField objekt bude sledovat změny stavu zobrazení, aby je bylo možné uložit ve vlastnosti ovládacího prvku ViewState a zachovat v požadavcích na stejnou stránku.

(Zděděno od DataControlField)

Platí pro

Viz také