TemplateField Třída

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

DataControlField
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 křestních jmen 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 TemplateField třídu k vytvoření vlastního uživatelského rozhraní (UI). Objekt TemplateField se zobrazuje odlišně v závislosti na ovládacím prvku vázaném na data, ve kterém se používá. GridView Například ovládací prvek zobrazí TemplateField objekt jako sloupec a DetailsView ovládací prvek ho zobrazí jako řádek.

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

Template	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 pro oddíl zápatí objektu TemplateField .
HeaderTemplate	Určuje obsah, který se má zobrazit pro oddíl záhlaví objektu TemplateField .
InsertItemTemplate	Určuje obsah, který se má zobrazit pro položku v režimu vložení 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 falsehodnotu .

Jako alternativu k definování vlastní HeaderTemplate nebo FooterTemplate šablony můžete přizpůsobit oddíly záhlaví a zápatí TemplateField objektu nastavením dalších vlastností objektu TemplateField . Chcete-li zobrazit titulek v oddílech záhlaví nebo zápatí, nastavte HeaderText FooterText nebo vlastnost. Místo zobrazení textu v oddílu záhlaví můžete obrázek zobrazit nastavením HeaderImageUrl vlastnosti. Oddíl záhlaví může být v objektu TemplateField skrytý nastavením ShowHeader vlastnosti na false.

Poznámka:

Některé ovládací prvky vázané na data (například GridView ovládací prvek) můžou zobrazit nebo skrýt pouze celý oddíl 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 celý oddíl záhlaví ovládacího prvku vázaného na data, použijte vlastnost ovládacího prvku ShowHeader (pokud je k dispozici).

Vzhled objektu TemplateField (barva písma, barva pozadí atd.) můžete také přizpůsobit nastavením vlastností stylu pro různé části pole. Následující tabulka uvádí různé vlastnosti stylu.

Vlastnost Style	Description
ControlStyle	Nastavení stylu podřízených ovládacích prvků webového serveru objektu TemplateField .
FooterStyle	Nastavení stylu pro oddíl zápatí objektu TemplateField .
HeaderStyle	Nastavení stylu pro oddíl záhlaví objektu TemplateField .
ItemStyle	Nastavení stylu datových položek v objektu TemplateField .

Konstruktory

Name	Description
TemplateField()	Inicializuje novou instanci TemplateField třídy.

Vlastnosti

Name	Description
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é objektu DataControlField . (Zděděno od DataControlField)
ConvertEmptyStringToNull	Získá nebo nastaví hodnotu určující, zda hodnota, na kterou TemplateField je objekt vázán, by měla být převedena na `null` , pokud je Empty.
DesignMode	Získá hodnotu označující, zda pole ovládacího prvku dat je aktuálně zobrazeno v návrhovém prostředí. (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í oddílu zápatí objektu TemplateField .
FooterText	Získá nebo nastaví text, který je zobrazen v zápatí položky 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í oddílu záhlaví objektu TemplateField .
HeaderText	Získá nebo nastaví text, který je zobrazen v záhlaví položky 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 určující, zda DataControlField objekt je viditelný, když nadřazený ovládací prvek vázané na data je v režimu vložení. (Zděděno od DataControlField)
IsTrackingViewState	Získá hodnotu určující, zda DataControlField objekt ukládá změny do jeho 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 určující, zda je položka záhlaví pole ovládacího prvku dat vykreslena. (Zděděno od DataControlField)
SortExpression	Získá nebo nastaví výraz řazení, který 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.
ViewState	Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení objektu DataControlField napříč více požadavky na stejnou stránku. (Zděděno od DataControlField)
Visible	Získá nebo nastaví hodnotu určující, zda je pole ovládacího prvku dat vykresleno. (Zděděno od DataControlField)

Metody

Name	Description
CloneField()	Vytvoří duplicitní kopii aktuálního DataControlFieldodvozeného objektu. (Zděděno od DataControlField)
CopyProperties(DataControlField)	Zkopíruje vlastnosti aktuálního TemplateField-odvozeného objektu do zadaného DataControlField objektu.
CreateField()	Vytvoří nový TemplateField objekt.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Extrahuje hodnotu polí ovládacího prvku dat zadaných jedním nebo více obousměrnými příkazy vazby (`DataBind`) z aktuální buňky tabulky a přidá hodnoty do zadané IOrderedDictionary kolekce.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type 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 Object. (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 doby, 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 do vlastnosti ovládacího prvku ViewState a zachovat v rámci požadavků na stejnou stránku. (Zděděno od DataControlField)
ValidateSupportsCallback()	Určuje, zda ovládací prvky obsažené v zpětném TemplateField volání stránky objektu podporují.

Explicitní implementace rozhraní

Name	Description
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 určující, zda DataControlField objekt ukládá změny do jeho 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 doby, 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 do vlastnosti ovládacího prvku ViewState a zachovat v rámci požadavků na stejnou stránku. (Zděděno od DataControlField)

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?