ButtonColumn Osztály

Definíció

Névtér:

System.Web.UI.WebControls

Szerelvény:

System.Web.dll

A felhasználó által DataGrid definiált gombot tartalmazó vezérlőelem oszloptípusa.

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

Öröklődés

Object

DataGridColumn

ButtonColumn

Példák

Az alábbi példakód bemutatja, hogyan használhatja ButtonColumn az osztályt egy DataGrid vezérlőben a Gombok hozzáadása parancs létrehozásához.

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

Megjegyzések

ButtonColumn A vezérlőelem osztályával DataGrid létrehozhat egy gombot, amely megfelel a vezérlőelem minden soránakDataGrid. Adja meg a gombokban megjelenő feliratot a Text tulajdonság beállításával. Ha beállítja a Text tulajdonságot, az ButtonColumn objektum összes gombja ugyanazzal a felirattal rendelkezik. Azt is megteheti, hogy egy adatforrás mezőihez köti a ButtonColumn gombokat. Ez lehetővé teszi, hogy különböző feliratokat jelenítsen meg az egyes gombokhoz. A szövegfelirat a megadott mezőben lévő értékeket használja. Állítsa be a DataTextField tulajdonságot úgy, hogy egy ButtonColumn adatforrás egy mezőjéhez kösse.

A gombokban megjelenő feliratok formázásához állítsa be a DataTextField tulajdonságot egy formázási sztringgel.

Az eseményt a gombokra ButtonColumn kattintva aktiválja ItemCommand . A gombra kattintáskor végrehajtott műveletet programozott módon szabályozhatja az esemény eseménykezelőjének ItemCommand megadásával.

Alapértelmezés szerint a rendszer nem hajtja végre az oldalérvényesítést, ha a ButtonColumn gombra kattint. Az oldalérvényesítés határozza meg, hogy az oldalon egy érvényesítési vezérlőhöz társított beviteli vezérlők mindegyike megfelel-e az érvényesítési vezérlő által megadott érvényesítési szabályoknak. Ha egy gombra kattintva oldalellenőrzést szeretne végezni, állítsa a tulajdonságot a CausesValidation következőre true: .

Konstruktorok

Name	Description
ButtonColumn()	Inicializálja a ButtonColumn osztály új példányát.

Tulajdonságok

Name	Description
ButtonType	Lekéri vagy beállítja az objektumban ButtonColumn megjelenítendő gomb típusát.
CausesValidation	Lekéri vagy beállít egy értéket, amely jelzi, hogy az ellenőrzés akkor történik-e, amikor az ButtonColumn objektum egyik gombjára kattint.
CommandName	Lekéri vagy beállít egy sztringet, amely az objektum egyik gombjára ButtonColumn kattintáskor végrehajtandó parancsot jelöli.
DataTextField	Lekéri vagy beállítja egy adatforrás mezőnevét az ButtonColumn objektumhoz való kötéshez.
DataTextFormatString	Lekéri vagy beállítja az egyes gombok feliratának megjelenítési formátumát meghatározó sztringet.
DesignMode	Olyan értéket kap, amely jelzi, hogy az oszlop tervező módban van-e. (Öröklődés forrása DataGridColumn)
FooterStyle	Lekéri az oszlop láblécszakaszának stílustulajdonságait. (Öröklődés forrása DataGridColumn)
FooterText	Lekéri vagy beállítja az oszlop láblécszakaszában megjelenő szöveget. (Öröklődés forrása DataGridColumn)
HeaderImageUrl	Lekéri vagy beállítja egy kép helyét, hogy megjelenjen az oszlop fejlécszakaszában. (Öröklődés forrása DataGridColumn)
HeaderStyle	Lekéri az oszlop fejlécszakaszának stílustulajdonságait. (Öröklődés forrása DataGridColumn)
HeaderText	Lekéri vagy beállítja az oszlop fejlécszakaszában megjelenő szöveget. (Öröklődés forrása DataGridColumn)
IsTrackingViewState	Olyan értéket kap, amely meghatározza, hogy az DataGridColumn objektum meg van-e jelölve az állapot mentéséhez. (Öröklődés forrása DataGridColumn)
ItemStyle	Lekéri az oszlop elemcelláinak stílustulajdonságait. (Öröklődés forrása DataGridColumn)
Owner	Lekéri azt a DataGrid vezérlőt, amelynek az oszlop tagja. (Öröklődés forrása DataGridColumn)
SortExpression	Lekéri vagy beállítja annak a mezőnek vagy kifejezésnek a nevét, amely a rendezéshez kijelölt oszlopot adja át a OnSortCommand(DataGridSortCommandEventArgs) metódusnak. (Öröklődés forrása DataGridColumn)
Text	Lekéri vagy beállítja az objektum gombjaiban ButtonColumn megjelenő feliratot.
ValidationGroup	Lekéri vagy beállítja azoknak az érvényesítési vezérlőknek a csoportját, amelyek esetében az ButtonColumn objektum érvényesítést okoz, amikor visszakerül a kiszolgálóra.
ViewState	Lekéri azt az StateBag objektumot, amely lehetővé teszi, hogy az DataGridColumn osztályból származó oszlop tárolja a tulajdonságait. (Öröklődés forrása DataGridColumn)
Visible	Lekéri vagy beállít egy értéket, amely jelzi, hogy az oszlop látható-e a DataGrid vezérlőben. (Öröklődés forrása DataGridColumn)

Metódusok

Name	Description
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
FormatDataTextValue(Object)	A megadott értéket a tulajdonság által DataTextFormatString jelzett formátumra konvertálja.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
Initialize()	Visszaállítja az ButtonColumn objektum kezdeti állapotát.
InitializeCell(TableCell, Int32, ListItemType)	Visszaállítja az objektum egy celláját a ButtonColumn kezdeti állapotára.
LoadViewState(Object)	Betölti DataGridColumn az objektum állapotát. (Öröklődés forrása DataGridColumn)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
OnColumnChanged()	Meghívja a OnColumnsChanged() metódust. (Öröklődés forrása DataGridColumn)
SaveViewState()	Menti az objektum aktuális állapotát DataGridColumn . (Öröklődés forrása DataGridColumn)
ToString()	Az oszlop sztring-ábrázolását adja vissza. (Öröklődés forrása DataGridColumn)
TrackViewState()	A kiszolgálóvezérlő nézetállapot-változásainak nyomon követését okozza, hogy azok a kiszolgálóvezérlő StateBag objektumában tárolhatók legyenek. (Öröklődés forrása DataGridColumn)

Explicit interfész-implementációk

Name	Description
IStateManager.IsTrackingViewState	Olyan értéket kap, amely jelzi, hogy az oszlop nyomon követi-e a nézet állapotának változásait. (Öröklődés forrása DataGridColumn)
IStateManager.LoadViewState(Object)	Betölti a korábban mentett állapotot. (Öröklődés forrása DataGridColumn)
IStateManager.SaveViewState()	Állapotváltozásokat tartalmazó objektumot ad vissza. (Öröklődés forrása DataGridColumn)
IStateManager.TrackViewState()	Megkezdi az állapotváltozások nyomon követését. (Öröklődés forrása DataGridColumn)

Lásd még

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