ButtonColumn 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í.

Typ sloupce pro DataGrid ovládací prvek, který obsahuje uživatelem definované tlačítko.

public ref class ButtonColumn : System::Web::UI::WebControls::DataGridColumn

public class ButtonColumn : System.Web.UI.WebControls.DataGridColumn

type ButtonColumn = class
    inherit DataGridColumn

Public Class ButtonColumn
Inherits DataGridColumn

Dědičnost: Object

DataGridColumn
ButtonColumn

Příklady

Následující příklad kódu ukazuje, jak použít ButtonColumn třídu v ovládacím DataGrid prvku k vytvoření přidat tlačítka.

private void Page_Init(Object sender, EventArgs e)
{

   // Create dynamic column to add to Columns collection.
   ButtonColumn AddColumn = new ButtonColumn();
   AddColumn.HeaderText="Add Item";
   AddColumn.Text="Add";
   AddColumn.CommandName="Add";
   AddColumn.ButtonType = ButtonColumnType.PushButton;

   // Add column to Columns collection.
   ItemsGrid.Columns.AddAt(2, AddColumn);
}

Private Sub Page_Init(sender As Object, e As EventArgs)
    
    ' Create dynamic column to add to Columns collection.
    Dim AddColumn As New ButtonColumn()
    AddColumn.HeaderText = "Add Item"
    AddColumn.Text = "Add"
    AddColumn.CommandName = "Add"
    AddColumn.ButtonType = ButtonColumnType.PushButton

    
    ' Add column to Columns collection.
    ItemsGrid.Columns.AddAt(2, AddColumn)
End Sub

Poznámky

ButtonColumn Pomocí třídy v ovládacím DataGrid prvku vytvořte tlačítko, které odpovídá každému DataGrid řádku ovládacího prvku. Určete popis, která se zobrazí v tlačítkách nastavením Text vlastnosti . Pokud nastavíte Text vlastnost , budou všechna tlačítka v objektu ButtonColumn sdílet stejnou popis. Případně můžete tlačítka svázat ButtonColumn s polem ve zdroji dat. To vám umožní zobrazit pro každé tlačítko různé titulky. Hodnoty v zadaném poli se použijí pro text popis. DataTextField Nastavte vlastnost pro vytvoření vazby ButtonColumn na pole ve zdroji dat.

Titulky zobrazené v tlačítkách můžete formátovat nastavením DataTextField vlastnosti s formátovacím řetězcem.

Kliknutím na tlačítka v souboru vyvoláte ButtonColumn ItemCommand událost. Můžete programově řídit akci, která se provede při kliknutí na tlačítko, poskytnutím obslužné rutiny události pro ItemCommand událost.

Ve výchozím nastavení se při kliknutí na tlačítko v objektu ButtonColumn neprovádí ověření stránky. Ověření stránky určuje, jestli vstupní ovládací prvky přidružené k ověřovacímu ovládacímu prvku na stránce projdou ověřovacími pravidly určenými ověřovacím ovládacím prvku. Pokud chcete provést ověření stránky při kliknutí na tlačítko, nastavte CausesValidation vlastnost na true.

Konstruktory

ButtonColumn()

Inicializuje novou instanci ButtonColumn třídy .

Vlastnosti

ButtonType	Získá nebo nastaví typ tlačítka k zobrazení v objektu ButtonColumn .
CausesValidation	Získá nebo nastaví hodnotu označující, zda je provedeno ověření při kliknutí na tlačítko v objektu ButtonColumn .
CommandName	Získá nebo nastaví řetězec, který představuje příkaz provést při kliknutí na tlačítko v objektu ButtonColumn .
DataTextField	Získá nebo nastaví název pole ze zdroje dat vytvořit vazbu k objektu ButtonColumn .
DataTextFormatString	Získá nebo nastaví řetězec, který určuje formát zobrazení pro popis v každém tlačítku.
DesignMode	Získá hodnotu, která označuje, zda je sloupec v režimu návrhu. (Zděděno od DataGridColumn)
FooterStyle	Získá vlastnosti stylu pro zápatí oddíl sloupce. (Zděděno od DataGridColumn)
FooterText	Získá nebo nastaví text zobrazený v zápatí oddíl sloupce. (Zděděno od DataGridColumn)
HeaderImageUrl	Získá nebo nastaví umístění obrázku k zobrazení v záhlaví oddílu sloupce. (Zděděno od DataGridColumn)
HeaderStyle	Získá vlastnosti stylu pro záhlaví oddíl sloupce. (Zděděno od DataGridColumn)
HeaderText	Získá nebo nastaví text zobrazený v záhlaví oddílu sloupce. (Zděděno od DataGridColumn)
IsTrackingViewState	Získá hodnotu, která určuje, zda DataGridColumn je objekt označen k uložení jeho stavu. (Zděděno od DataGridColumn)
ItemStyle	Získá vlastnosti stylu pro buňky položky sloupce. (Zděděno od DataGridColumn)
Owner	DataGrid Získá ovládací prvek, který sloupec je členem. (Zděděno od DataGridColumn)
SortExpression	Získá nebo nastaví název pole nebo výrazu předat OnSortCommand(DataGridSortCommandEventArgs) metodě při výběru sloupce pro řazení. (Zděděno od DataGridColumn)
Text	Získá nebo nastaví popis, která se zobrazí v tlačítkách objektuButtonColumn.
ValidationGroup	Získá nebo nastaví skupinu ovládacích prvků ověření, pro které ButtonColumn objekt způsobí ověření při odeslání zpět na server.
ViewState	StateBag Získá objekt, který umožňuje sloupec odvozený z DataGridColumn třídy uložit jeho vlastnosti. (Zděděno od DataGridColumn)
Visible	Získá nebo nastaví hodnotu, která označuje, zda je sloupec viditelný v ovládacím DataGrid prvku. (Zděděno od DataGridColumn)

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
FormatDataTextValue(Object)	Převede zadanou hodnotu do formátu, který je označen DataTextFormatString vlastností .
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()	Obnoví objekt do počátečního ButtonColumn stavu.
InitializeCell(TableCell, Int32, ListItemType)	Obnoví buňku v objektu do původního ButtonColumn stavu.
LoadViewState(Object)	Načte stav objektu DataGridColumn . (Zděděno od DataGridColumn)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnColumnChanged()	Zavolá metodu OnColumnsChanged() . (Zděděno od DataGridColumn)
SaveViewState()	Uloží aktuální stav objektu DataGridColumn . (Zděděno od DataGridColumn)
ToString()	Vrátí řetězcovou reprezentaci sloupce. (Zděděno od DataGridColumn)
TrackViewState()	Způsobí sledování změn stavu zobrazení v ovládacím prvku serveru, aby mohly být uloženy v objektu ovládacího prvku StateBag serveru. (Zděděno od DataGridColumn)

Explicitní implementace rozhraní

IStateManager.IsTrackingViewState	Získá hodnotu, která označuje, zda sloupec sleduje změny stavu zobrazení. (Zděděno od DataGridColumn)
IStateManager.LoadViewState(Object)	Načte dříve uložený stav. (Zděděno od DataGridColumn)
IStateManager.SaveViewState()	Vrátí objekt obsahující změny stavu. (Zděděno od DataGridColumn)
IStateManager.TrackViewState()	Začne sledovat změny stavu. (Zděděno od DataGridColumn)

Platí pro