ButtonField 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é 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 použití ButtonField objektu 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 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í ButtonField objekt jako sloupec, zatímco DetailsView ovládací prvek ho zobrazí jako řádek.

Kliknutí na tlačítko v poli tlačítka 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 určit index záznamu, který vyvolá událost příkazu, použijte CommandArgument vlastnost argumentu události, který je předán do události příkazu pro ovládací prvek vázané na data. Třída ButtonField automaticky naplní CommandArgument vlastnost odpovídající hodnotou indexu.

Chcete-li určit typ tlačítka, který se má zobrazit, použijte ButtonType vlastnost. Při zobrazení odkazu nebo příkazového tlačítka použijte Text vlastnost k určení titulku, který se má zobrazit v tlačítkách.

Poznámka:

Pokud nastavíte Text vlastnost, všechna tlačítka ve ButtonField sdílené složce mají stejný titulek.

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žívají pro textové titulky tlačítek. DataTextField Nastavte vlastnost pro vazbu objektu ButtonField na pole ve zdroji dat.

Při zobrazení tlačítka obrázku použijte ImageUrl 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 falsehodnotu .

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

Vzhled objektu ButtonField (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	Nastavení stylu pro
ControlStyle	Podřízený webový server ovládací prvky ButtonField.
FooterStyle	Část zápatí ButtonField.
HeaderStyle	Oddíl záhlaví ButtonField.
ItemStyle	Datové položky v souboru ButtonField.

Konstruktory

Name	Description
ButtonField()	Inicializuje novou instanci ButtonField 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)
ButtonType	Získá nebo nastaví typ tlačítka pro zobrazení v poli tlačítka. (Zděděno od ButtonFieldBase)
CausesValidation	Získá nebo nastaví hodnotu urč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é 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 pole ovládacího prvku dat je aktuálně zobrazeno v návrhovém prostředí. (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í 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)
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)
ImageUrl	Získá nebo nastaví obrázek pro zobrazení pro každé tlačítko v objektu ButtonField .
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)
ShowHeader	Získá nebo nastaví hodnotu určující, zda je oddíl záhlaví zobrazen v objektu ButtonFieldBase . (Zděděno od ButtonFieldBase)
SortExpression	Získá nebo nastaví výraz řazení, který používá ovládací prvek zdroje dat k řazení dat. (Zděděno od DataControlField)
Text	Získá nebo nastaví statický titulek, který se zobrazí pro každé tlačítko v objektu ButtonField .
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 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 ButtonField objektu do zadaného DataControlField objektu.
CreateField()	Vytvoří a vrátí novou instanci ButtonField třídy.
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 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)	Naformátuje zadanou hodnotu pole pro buňku v objektu ButtonField .
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)	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 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 objektu ButtonField podporují zpětné volání.

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á?

Sdílet prostřednictvím

ButtonField Třída

Definice

Příklady

Poznámky

Konstruktory

Vlastnosti

Metody

Explicitní implementace rozhraní

Platí pro

Viz také

Váš názor