ButtonColumn.ButtonType Property

Reference

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets the type of button to display in the ButtonColumn object.

public:
 virtual property System::Web::UI::WebControls::ButtonColumnType ButtonType { System::Web::UI::WebControls::ButtonColumnType get(); void set(System::Web::UI::WebControls::ButtonColumnType value); };

public virtual System.Web.UI.WebControls.ButtonColumnType ButtonType { get; set; }

member this.ButtonType : System.Web.UI.WebControls.ButtonColumnType with get, set

Public Overridable Property ButtonType As ButtonColumnType

Property Value

ButtonColumnType

One of the ButtonColumnType values. The default is LinkButton.

Exceptions

ArgumentOutOfRangeException

The specified column type is not one of the ButtonColumnType values.

Examples

The following code example demonstrates how use the ButtonType property to specify that the buttons in the ButtonColumn object are displayed as push buttons.

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

Remarks

Use the ButtonType property to specify whether the buttons in the ButtonColumn object are displayed as link or push buttons. The following table lists the possible settings.

Button type	Display
LinkButton	A link.
PushButton	A button control.

Clicking the buttons in the ButtonColumn raises the ItemCommand event. You can programmatically control the action that is performed when the button is clicked by providing an event handler for the ItemCommand event.

The value of this property is stored in view state.

Applies to

Product	Versions
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Share via