ButtonField Třída

Reference

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é se zobrazí jako tlačítko v ovládacím prvku vázaném na data.

public ref class ButtonField : System::Web::UI::WebControls::ButtonFieldBase

public class ButtonField : System.Web.UI.WebControls.ButtonFieldBase

type ButtonField = class
    inherit ButtonFieldBase

Public Class ButtonField
Inherits ButtonFieldBase

Dědičnost: Object

DataControlField

ButtonFieldBase
ButtonField

Příklady

Následující příklad kódu ukazuje, jak použít ButtonField objekt k zobrazení sloupce příkazových tlačítek v ovládacím GridView prvku.


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void CustomersGridView_RowCommand(Object sender, GridViewCommandEventArgs e)
  {
  
    // If multiple ButtonField column fields are used, use the
    // CommandName property to determine which button was clicked.
    if(e.CommandName=="Select")
    {
    
      // Convert the row index stored in the CommandArgument
      // property to an Integer.
      int index = Convert.ToInt32(e.CommandArgument);    
    
      // Get the last name of the selected author from the appropriate
      // cell in the GridView control.
      GridViewRow selectedRow = CustomersGridView.Rows[index];
      TableCell contactName = selectedRow.Cells[1];
      string contact = contactName.Text;  
    
      // Display the selected author.
      Message.Text = "You selected " + contact + ".";
      
    }
    
  }
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ButtonField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>ButtonField Example</h3>
      
      <asp:label id="Message"
        forecolor="Red"
        runat="server"
        AssociatedControlID="CustomersGridView"/>
                    
      <!-- Populate the Columns collection declaratively. -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        onrowcommand="CustomersGridView_RowCommand"
        runat="server">
                
        <columns>
                
          <asp:buttonfield buttontype="Button" 
            commandname="Select"
            headertext="Select Customer" 
            text="Select"/>
          <asp:boundfield datafield="CompanyName" 
            headertext="Company Name"/>
          <asp:boundfield datafield="ContactName" 
            headertext="Contact Name"/>
                
        </columns>
                
      </asp:gridview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database.                   -->
        <asp:sqldatasource id="CustomersSqlDataSource"  
          selectcommand="Select [CustomerID], [CompanyName], [ContactName], [ContactTitle] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
          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">
<script runat="server">

    Sub CustomersGridView_RowCommand(ByVal sender As Object, ByVal e As GridViewCommandEventArgs)
  
        ' If multiple ButtonField column fields are used, use the
        ' CommandName property to determine which button was clicked.
        If e.CommandName = "Select" Then
    
            ' Convert the row index stored in the CommandArgument
            ' property to an Integer.
            Dim index As Integer = Convert.ToInt32(e.CommandArgument)
    
            ' Get the last name of the selected author from the appropriate
            ' cell in the GridView control.
            Dim selectedRow As GridViewRow = CustomersGridView.Rows(index)
            Dim contactCell As TableCell = selectedRow.Cells(1)
            Dim contact As String = contactCell.Text
    
            ' Display the selected author.
            Message.Text = "You selected " & contact & "."
      
        End If
    
    End Sub
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ButtonField Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>ButtonField Example</h3>
      
      <asp:label id="Message"
        forecolor="Red"
        runat="server"
        AssociatedControlID="CustomersGridView"/>
                    
      <!-- Populate the Columns collection declaratively. -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        onrowcommand="CustomersGridView_RowCommand"
        runat="server">
                
        <columns>
                
          <asp:buttonfield buttontype="Button" 
            commandname="Select"
            headertext="Select Customer" 
            text="Select"/>
          <asp:boundfield datafield="CompanyName" 
            headertext="Company Name"/>
          <asp:boundfield datafield="ContactName" 
            headertext="Contact Name"/>
                
        </columns>
                
      </asp:gridview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database.                   -->
        <asp:sqldatasource id="CustomersSqlDataSource"  
          selectcommand="Select [CustomerID], [CompanyName], [ContactName], [ContactTitle] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
          runat="server">
        </asp:sqldatasource>
            
    </form>
  </body>
</html>

Poznámky

Třídu ButtonField používají ovládací prvky vázané na data (například GridView a DetailsView) k zobrazení tlačítka pro každý zobrazený záznam. Objekt ButtonField 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í ButtonField objekt jako sloupec, zatímco DetailsView ovládací prvek ho zobrazí jako řádek.

Kliknutím na tlačítko v poli tlačítka se vyvolá událost příkazu nadřazeného ovládacího prvku vázaného na data. Můžete zadat vlastní rutinu, která se má provést při kliknutí na příkazové tlačítko, zadáním obslužné rutiny události pro událost příkazu.

Poznámka

Ovládací GridView prvek vyvolá RowCommand událost, zatímco DetailsView ovládací prvek vyvolá ItemCommand událost.

Chcete-li zjistit index záznamu, který vyvolává událost příkazu, použijte CommandArgument vlastnost argumentu události, který je předán události příkazu pro ovládací prvek vázané na data. Třída ButtonField automaticky naplní CommandArgument vlastnost příslušnou hodnotou indexu.

Pokud chcete určit typ tlačítka, které se má zobrazit, použijte ButtonType vlastnost . Při zobrazení odkazu nebo příkazového tlačítka zadejte Text pomocí vlastnosti popis, která se má v tlačítkách zobrazit.

Poznámka

Pokud nastavíte Text vlastnost , všechna tlačítka v objektu sdílejí stejnou ButtonField popis.

Alternativně můžete objekt svázat ButtonField s polem ve zdroji dat. To umožňuje zobrazit různé titulky tlačítek v objektu ButtonField . Hodnoty, které jsou v zadaném poli, se použijí pro textové titulky tlačítek. DataTextField Nastavte vlastnost pro vytvoření vazby objektu ButtonField na pole ve zdroji dat.

Při zobrazení tlačítka obrázku ImageUrl použijte vlastnost k určení obrázku, který se má zobrazit pro tlačítka v objektu ButtonField .

Poznámka

Všechna tlačítka v objektu ButtonField sdílejí stejný obrázek.

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

Objekt ButtonField umožňuje přizpůsobit oddíly záhlaví a zápatí. Pokud chcete v oddílu záhlaví nebo zápatí zobrazit popis, nastavte HeaderText vlastnosti nebo FooterText . Místo zobrazení textu v oddílu záhlaví můžete zobrazit obrázek nastavením HeaderImageUrl vlastnosti . Pokud chcete skrýt oddíl záhlaví v objektu ButtonField , nastavte ShowHeader vlastnost 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á pole tlačítka. Pokud chcete zobrazit nebo skrýt celou část záhlaví ovládacího prvku vázaného na data (pokud je k dispozici), použijte ShowHeader vlastnost ovládacího prvku.

Můžete také přizpůsobit vzhled objektu ButtonField (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	Nastavení stylu pro
ControlStyle	Podřízený webový server řídí ButtonField.
FooterStyle	Část zápatí .ButtonField
HeaderStyle	Oddíl záhlaví v ButtonFieldsouboru .
ItemStyle	Datové položky v .ButtonField

Konstruktory

ButtonField()

Inicializuje novou instanci ButtonField 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)
ButtonType	Získá nebo nastaví typ tlačítka k zobrazení v poli tlačítka. (Zděděno od ButtonFieldBase)
CausesValidation	Získá nebo nastaví hodnotu označující, zda je provedeno ověření při kliknutí na tlačítko v objektu ButtonFieldBase . (Zděděno od ButtonFieldBase)
CommandName	Získá nebo nastaví řetězec, který představuje akci provést při kliknutí na tlačítko v objektu ButtonField .
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)
DataTextField	Získá nebo nastaví název datového pole, pro které je hodnota vázána na Text vlastnost Button ovládacího prvku, který je vykreslen objektem ButtonField .
DataTextFormatString	Získá nebo nastaví řetězec, který určuje formát zobrazení pro hodnotu pole.
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)
FooterStyle	Získá nebo nastaví styl zápatí pole ovládacího prvku dat. (Zděděno od DataControlField)
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)
HeaderText	Získá nebo nastaví text, který je zobrazen v záhlaví pole ovládacího prvku dat. (Zděděno od DataControlField)
ImageUrl	Získá nebo nastaví obrázek k zobrazení pro každé tlačítko v objektu ButtonField .
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)
ShowHeader	Získá nebo nastaví hodnotu označující, zda záhlaví oddíl je zobrazen v objektu ButtonFieldBase . (Zděděno od ButtonFieldBase)
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)
Text	Získá nebo nastaví statickou popis, která se zobrazí pro každé tlačítko v objektuButtonField.
ValidateRequestMode	Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek ověřuje vstup klienta. (Zděděno od DataControlField)
ValidationGroup	Získá nebo nastaví název skupiny ověřovacích ovládacích prvků k ověření při kliknutí na tlačítko v objektu ButtonFieldBase . (Zděděno od ButtonFieldBase)
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 ButtonField objektu do zadaného DataControlField objektu.
CreateField()	Vytvoří a vrátí novou instanci ButtonField třídy .
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Extrahuje hodnotu pole ovládacího prvku dat z aktuální buňky tabulky a přidá hodnotu do zadané IDictionary kolekce. (Zděděno od DataControlField)
FormatDataTextValue(Object)	Formátuje zadanou hodnotu pole pro buňku v objektu ButtonField .
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)	Inicializuje aktuální ButtonField objekt.
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Inicializuje zadaný DataControlFieldCell objekt do zadaného stavu řádku.
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 ButtonField podporují zpětná volání.

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

Sdílet prostřednictvím

ButtonField Třída

Definice

Příklady

Poznámky

Konstruktory

Vlastnosti

Metody

Explicitní implementace rozhraní

Platí pro

Viz také

Další materiály