Sdílet prostřednictvím


ButtonField Třída

Definice

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

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

Viz také