ButtonColumn Klas

Definitie

Naamruimte:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Een kolomtype voor het besturingselement dat een door de DataGrid gebruiker gedefinieerde knop bevat.

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

Overname: Object

DataGridColumn
ButtonColumn

Voorbeelden

In het volgende codevoorbeeld ziet u hoe ButtonColumn u klasse gebruikt in een DataGrid besturingselement om knoppen toevoegen te maken.

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

Opmerkingen

Gebruik de ButtonColumn klasse in een DataGrid besturingselement om een knop te maken die overeenkomt met elke rij in het DataGrid besturingselement. Geef het bijschrift op dat wordt weergegeven in de knoppen door de eigenschap in te Text stellen. Als u de Text eigenschap instelt, delen alle knoppen in het ButtonColumn object hetzelfde bijschrift. U kunt de ButtonColumn knoppen ook koppelen aan een veld in een gegevensbron. Hiermee kunt u voor elke knop verschillende bijschriften weergeven. De waarden in het opgegeven veld worden gebruikt voor het bijschrift. Stel de eigenschap in om het DataTextField ButtonColumn te binden aan een veld in een gegevensbron.

U kunt de bijschriften opmaken die in de knoppen worden weergegeven door de DataTextField eigenschap in te stellen met een opmaaktekenreeks.

Als u op de knoppen in de ButtonColumn knop klikt, wordt de ItemCommand gebeurtenis gegenereerd. U kunt programmatisch bepalen welke actie wordt uitgevoerd wanneer op de knop wordt geklikt door een gebeurtenishandler voor de ItemCommand gebeurtenis op te geven.

Paginavalidatie wordt standaard niet uitgevoerd wanneer op een knop in de ButtonColumn knop wordt geklikt. Paginavalidatie bepaalt of de invoerbesturingselementen die zijn gekoppeld aan een validatiebesturingselement op de pagina, alle validatieregels doorstaan die door het validatiebesturingselement worden opgegeven. Als u paginavalidatie wilt uitvoeren wanneer op een knop wordt geklikt, stelt u de CausesValidation eigenschap in op true.

Constructors

Name	Description
ButtonColumn()	Initialiseert een nieuw exemplaar van de ButtonColumn klasse.

Eigenschappen

Name	Description
ButtonType	Hiermee wordt het type knop opgehaald of ingesteld dat in het ButtonColumn object moet worden weergegeven.
CausesValidation	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de validatie wordt uitgevoerd wanneer op een knop in het ButtonColumn object wordt geklikt.
CommandName	Hiermee haalt u een tekenreeks op die de opdracht vertegenwoordigt die moet worden uitgevoerd wanneer op een knop in het ButtonColumn object wordt geklikt.
DataTextField	Hiermee haalt u de veldnaam van een gegevensbron op of stelt u deze in om verbinding te maken met het ButtonColumn object.
DataTextFormatString	Hiermee haalt u de tekenreeks op waarmee de weergave-indeling voor het bijschrift in elke knop wordt opgegeven.
DesignMode	Hiermee wordt een waarde opgehaald die aangeeft of de kolom zich in de ontwerpmodus bevindt. (Overgenomen van DataGridColumn)
FooterStyle	Hiermee haalt u de stijleigenschappen voor de voettekstsectie van de kolom op. (Overgenomen van DataGridColumn)
FooterText	Hiermee wordt de tekst opgehaald of ingesteld die wordt weergegeven in de voettekstsectie van de kolom. (Overgenomen van DataGridColumn)
HeaderImageUrl	Hiermee wordt de locatie van een afbeelding opgehaald of ingesteld om weer te geven in de koptekstsectie van de kolom. (Overgenomen van DataGridColumn)
HeaderStyle	Hiermee haalt u de stijleigenschappen voor de koptekstsectie van de kolom op. (Overgenomen van DataGridColumn)
HeaderText	Hiermee wordt de tekst opgehaald of ingesteld die wordt weergegeven in de koptekstsectie van de kolom. (Overgenomen van DataGridColumn)
IsTrackingViewState	Hiermee wordt een waarde opgehaald die bepaalt of het object is gemarkeerd om de DataGridColumn status op te slaan. (Overgenomen van DataGridColumn)
ItemStyle	Hiermee haalt u de stijleigenschappen voor de itemcellen van de kolom op. (Overgenomen van DataGridColumn)
Owner	Hiermee haalt u het DataGrid besturingselement op waarvan de kolom lid is. (Overgenomen van DataGridColumn)
SortExpression	Hiermee haalt u de naam van het veld of de expressie op die moet worden doorgegeven aan de OnSortCommand(DataGridSortCommandEventArgs) methode wanneer een kolom is geselecteerd voor sorteren. (Overgenomen van DataGridColumn)
Text	Hiermee wordt het bijschrift opgehaald of ingesteld dat wordt weergegeven in de knoppen van het ButtonColumn object.
ValidationGroup	Hiermee wordt de groep validatiebesturingselementen opgehaald of ingesteld waarvoor het object validatie veroorzaakt wanneer het ButtonColumn object wordt teruggezet naar de server.
ViewState	Hiermee haalt u het StateBag object op waarmee een kolom die is afgeleid van de DataGridColumn klasse, de eigenschappen ervan kan opslaan. (Overgenomen van DataGridColumn)
Visible	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de kolom zichtbaar is in het DataGrid besturingselement. (Overgenomen van DataGridColumn)

Methoden

Name	Description
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
FormatDataTextValue(Object)	Converteert de opgegeven waarde naar de indeling die wordt aangegeven door de DataTextFormatString eigenschap.
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
Initialize()	Hiermee stelt u het ButtonColumn object opnieuw in op de oorspronkelijke status.
InitializeCell(TableCell, Int32, ListItemType)	Hiermee stelt u een cel in het ButtonColumn object opnieuw in op de oorspronkelijke status.
LoadViewState(Object)	Laadt de status van het DataGridColumn object. (Overgenomen van DataGridColumn)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
OnColumnChanged()	Roept de OnColumnsChanged() methode aan. (Overgenomen van DataGridColumn)
SaveViewState()	Hiermee wordt de huidige status van het DataGridColumn object opgeslagen. (Overgenomen van DataGridColumn)
ToString()	Retourneert de tekenreeksweergave van de kolom. (Overgenomen van DataGridColumn)
TrackViewState()	Veroorzaakt het bijhouden van wijzigingen in de weergavestatus in het serverbesturingselement, zodat deze kunnen worden opgeslagen in het object van StateBag het serverbesturingselement. (Overgenomen van DataGridColumn)

Expliciete interface-implementaties

Name	Description
IStateManager.IsTrackingViewState	Hiermee wordt een waarde opgehaald die aangeeft of de kolom de status van de weergave bijhoudt. (Overgenomen van DataGridColumn)
IStateManager.LoadViewState(Object)	Laadt eerder opgeslagen status. (Overgenomen van DataGridColumn)
IStateManager.SaveViewState()	Retourneert een object met statuswijzigingen. (Overgenomen van DataGridColumn)
IStateManager.TrackViewState()	Hiermee worden statuswijzigingen bijgehouden. (Overgenomen van DataGridColumn)

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?