ButtonColumn Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Tipo de columna para el control DataGrid que contiene un botón definido por el usuario.
public ref class ButtonColumn : System::Web::UI::WebControls::DataGridColumnpublic class ButtonColumn : System.Web.UI.WebControls.DataGridColumntype ButtonColumn = class
inherit DataGridColumnPublic Class ButtonColumn
Inherits DataGridColumn- Herencia
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) |
