ButtonColumn Třída

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.dll

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

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í tlačítek Přidat .

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. Nastavením vlastnosti určete titulek, který se zobrazí v tlačítkách Text . Pokud nastavíte Text vlastnost, všechna tlačítka v objektu ButtonColumn sdílejí stejný titulek. Alternativně můžete tlačítka svázat ButtonColumn s polem ve zdroji dat. To umožňuje zobrazit různé titulky pro každé tlačítko. Hodnoty v zadaném poli se používají pro textový titulek. DataTextField Nastavte vlastnost tak, aby se svážela ButtonColumn s polem ve zdroji dat.

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

Kliknutím na tlačítka v události ButtonColumn vyvoláte ItemCommand událost. Akce, která se provádí při kliknutí na tlačítko, můžete programově řídit zadáním obslužné rutiny události události.ItemCommand

Ve výchozím nastavení se při kliknutí na tlačítko na ButtonColumn tlačítko neprovádí ověření stránky. Ověření stránky určuje, zda vstupní ovládací prvky, které jsou přidruženy k ověřovacímu ovládacímu prvku na stránce, projdou všemi ověřovacími pravidly určenými ověřovacím ovládacím prvku. Chcete-li provést ověření stránky při kliknutí na tlačítko, nastavte CausesValidation vlastnost na true.

Konstruktory

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

Vlastnosti

Name	Description
ButtonType	Získá nebo nastaví typ tlačítka pro zobrazení v objektu ButtonColumn .
CausesValidation	Získá nebo nastaví hodnotu urč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 pro vazbu k objektu ButtonColumn .
DataTextFormatString	Získá nebo nastaví řetězec, který určuje formát zobrazení titulku 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 oddíl zápatí sloupce. (Zděděno od DataGridColumn)
FooterText	Získá nebo nastaví text zobrazený v zápatí oddílu sloupce. (Zděděno od DataGridColumn)
HeaderImageUrl	Získá nebo nastaví umístění obrázku, který se zobrazí v oddílu záhlaví sloupce. (Zděděno od DataGridColumn)
HeaderStyle	Získá vlastnosti stylu pro oddíl záhlaví 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 ve sloupci. (Zděděno od DataGridColumn)
Owner	DataGrid Získá ovládací prvek, který je sloupec členem. (Zděděno od DataGridColumn)
SortExpression	Získá nebo nastaví název pole nebo výraz předat metodě OnSortCommand(DataGridSortCommandEventArgs) při výběru sloupce pro řazení. (Zděděno od DataGridColumn)
Text	Získá nebo nastaví titulek, který se zobrazí v tlačítkách objektu ButtonColumn .
ValidationGroup	Získá nebo nastaví skupinu ověřovacích ovládacích prvků, pro které ButtonColumn objekt způsobí ověření, když publikuje 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á určuje, zda je sloupec viditelný v ovládacím DataGrid prvku. (Zděděno od DataGridColumn)

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven 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í funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
Initialize()	ButtonColumn Obnoví objekt do původního stavu.
InitializeCell(TableCell, Int32, ListItemType)	Obnoví buňku v objektu ButtonColumn do původního stavu.
LoadViewState(Object)	Načte stav objektu DataGridColumn . (Zděděno od DataGridColumn)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
OnColumnChanged()	Volá 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 je bylo možné uložit do objektu StateBag ovládacího prvku serveru. (Zděděno od DataGridColumn)

Explicitní implementace rozhraní

Name	Description
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()	Spustí sledování změn stavu. (Zděděno od DataGridColumn)

Viz také

• DataGrid
• DataGridColumn
• BoundColumn
• EditCommandColumn
• HyperLinkColumn
• TemplateColumn
• Button
• LinkButton