ButtonColumn Clase

Definición

Espacio de nombres:

System.Web.UI.WebControls

Ensamblado:

System.Web.dll

Tipo de columna para el control DataGrid que contiene un botón definido por el usuario.

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

Herencia

Object

DataGridColumn

ButtonColumn

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar ButtonColumn la clase en un DataGrid control para crear botones Agregar .

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

Comentarios

Use la ButtonColumn clase de un DataGrid control para crear un botón que se corresponda con cada fila del DataGrid control. Especifique el subtítulo que se muestra en los botones estableciendo la Text propiedad . Si establece la Text propiedad , todos los botones del ButtonColumn objeto comparten el mismo subtítulo. Como alternativa, puede enlazar los ButtonColumn botones a un campo de un origen de datos. Esto le permite mostrar diferentes títulos para cada botón. Los valores del campo especificado se usan para el texto subtítulo. Establezca la DataTextField propiedad para enlazar a ButtonColumn un campo de un origen de datos.

Puede dar formato a los títulos que se muestran en los botones estableciendo la DataTextField propiedad con una cadena de formato.

Al hacer clic en los botones del ButtonColumn evento, se genera el ItemCommand evento . Puede controlar mediante programación la acción que se realiza cuando se hace clic en el botón proporcionando un controlador de eventos para el ItemCommand evento.

De forma predeterminada, la validación de páginas no se realiza cuando se hace clic en un botón de .ButtonColumn La validación de páginas determina si los controles de entrada asociados a un control de validación de la página pasan todas las reglas de validación especificadas por el control de validación. Para realizar la validación de páginas cuando se hace clic en un botón, establezca la CausesValidation propiedad trueen .

Constructores

ButtonColumn()

Inicializa una nueva instancia de la clase ButtonColumn.

Propiedades

ButtonType	Obtiene o establece el tipo de botón que se muestra en el objeto ButtonColumn.
CausesValidation	Obtiene o establece un valor que indica si se realiza la validación al hacer clic en un botón del objeto ButtonColumn.
CommandName	Obtiene o establece una cadena que representa el comando que se ejecuta al hacer clic en un botón del objeto ButtonColumn.
DataTextField	Obtiene o establece el nombre de campo de un origen de datos que se va a enlazar al objeto ButtonColumn.
DataTextFormatString	Obtiene o establece la cadena que especifica el formato de presentación del título de cada botón.
DesignMode	Obtiene un valor que indica si la columna está en modo de diseño. (Heredado de DataGridColumn)
FooterStyle	Obtiene las propiedades de estilo de la sección de pie de página de la columna. (Heredado de DataGridColumn)
FooterText	Obtiene o establece el texto que se muestra en la sección de pie de página de la columna. (Heredado de DataGridColumn)
HeaderImageUrl	Obtiene o establece la ubicación de una imagen que se va a mostrar en la sección de encabezado de la columna. (Heredado de DataGridColumn)
HeaderStyle	Obtiene las propiedades de estilo de la sección de encabezado de la columna. (Heredado de DataGridColumn)
HeaderText	Obtiene o establece el texto que se muestra en la sección de encabezado de la columna. (Heredado de DataGridColumn)
IsTrackingViewState	Obtiene un valor que determina si el objeto DataGridColumn se marca para que guarde su estado. (Heredado de DataGridColumn)
ItemStyle	Obtiene las propiedades de estilo de las celdas de elemento de la columna. (Heredado de DataGridColumn)
Owner	Obtiene el control DataGrid del que forma parte la columna. (Heredado de DataGridColumn)
SortExpression	Obtiene o establece el nombre del campo o expresión que se va a pasar al método OnSortCommand(DataGridSortCommandEventArgs) cuando se selecciona una columna para ordenarla. (Heredado de DataGridColumn)
Text	Obtiene o establece el título que se muestra en los botones del objeto ButtonColumn.
ValidationGroup	Obtiene o establece el grupo de controles de validación para los que el objeto ButtonColumn ejecuta la validación cuando realiza devoluciones de datos al servidor.
ViewState	Obtiene el objeto StateBag, que permite a una columna derivada de la clase DataGridColumn almacenar sus propiedades. (Heredado de DataGridColumn)
Visible	Obtiene o establece un valor que indica si se muestra la columna en el control DataGrid. (Heredado de DataGridColumn)

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
FormatDataTextValue(Object)	Convierte el valor especificado al formato indicado por la propiedad DataTextFormatString.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
Initialize()	Restablece el estado inicial del objeto ButtonColumn.
InitializeCell(TableCell, Int32, ListItemType)	Restablece el estado inicial de una celda del objeto ButtonColumn.
LoadViewState(Object)	Carga el estado del objeto DataGridColumn. (Heredado de DataGridColumn)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnColumnChanged()	Llama al método OnColumnsChanged(). (Heredado de DataGridColumn)
SaveViewState()	Guarda el estado actual del objeto DataGridColumn. (Heredado de DataGridColumn)
ToString()	Devuelve la representación de cadena de la columna. (Heredado de DataGridColumn)
TrackViewState()	Origina el seguimiento de los cambios del estado de vista del control de servidor de manera que se puedan almacenar en el objeto StateBag del control de servidor. (Heredado de DataGridColumn)

Implementaciones de interfaz explícitas

IStateManager.IsTrackingViewState	Obtiene un valor que indica si la columna está efectuando un seguimiento de los cambios del estado de vista. (Heredado de DataGridColumn)
IStateManager.LoadViewState(Object)	Carga el estado guardado anteriormente. (Heredado de DataGridColumn)
IStateManager.SaveViewState()	Devuelve un objeto que contiene los cambios de estado. (Heredado de DataGridColumn)
IStateManager.TrackViewState()	Inicia el seguimiento de los cambios de estado. (Heredado de DataGridColumn)

Consulte también

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