DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) Método
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í.
Inserta una columna en el índice especificado de la colección.
public:
virtual void Insert(int columnIndex, System::Windows::Forms::DataGridViewColumn ^ dataGridViewColumn);public virtual void Insert(int columnIndex, System.Windows.Forms.DataGridViewColumn dataGridViewColumn);abstract member Insert : int * System.Windows.Forms.DataGridViewColumn -> unit
override this.Insert : int * System.Windows.Forms.DataGridViewColumn -> unitPublic Overridable Sub Insert (columnIndex As Integer, dataGridViewColumn As DataGridViewColumn)Parámetros
- columnIndex
- Int32
Índice de base cero en el que se va a insertar la columna especificada.
- dataGridViewColumn
- DataGridViewColumn
que DataGridViewColumn se va a insertar.
Excepciones
dataGridViewColumn es null.
El control asociado DataGridView está realizando una de las siguientes acciones que impide temporalmente que se agreguen nuevas columnas:
Selección de todas las celdas del control.
Borrar la selección.
Actualización de los valores de propiedad de columna DisplayIndex .
O bien
Se llama a este método desde un controlador para uno de los eventos siguientes DataGridView :
O bien
dataGridViewColumn ya pertenece a un DataGridView control .
O bien
El dataGridViewColumnSortMode valor de la propiedad es Automatic y el valor de propiedad SelectionMode es FullColumnSelect o ColumnHeaderSelect. Use el control ISupportInitialize.BeginInit() y ISupportInitialize.EndInit() los métodos para establecer temporalmente valores de propiedad en conflicto.
O bien
El dataGridViewColumnInheritedAutoSizeMode valor de la propiedad es ColumnHeader y el valor de propiedad ColumnHeadersVisible es false.
O bien
dataGridViewColumn tiene un InheritedAutoSizeMode valor de propiedad de Fill y un Frozen valor de propiedad de true.
O bien
dataGridViewColumn tiene DisplayIndex valores de propiedad y Frozen que lo mostrarían entre un conjunto de columnas adyacentes con el valor de propiedad opuesto Frozen .
O bien
El DataGridView control contiene al menos una fila y dataGridViewColumn tiene un CellType valor de propiedad de null.
Ejemplos
En el ejemplo de código siguiente se muestra el uso de este método. Para obtener más información, vea How to: Add an Unbound Column to a Data-Bound Windows Forms DataGridView Control.
private void CreateUnboundButtonColumn()
{
// Initialize the button column.
DataGridViewButtonColumn buttonColumn =
new DataGridViewButtonColumn();
buttonColumn.Name = "Details";
buttonColumn.HeaderText = "Details";
buttonColumn.Text = "View Details";
// Use the Text property for the button text for all cells rather
// than using each cell's value as the text for its own button.
buttonColumn.UseColumnTextForButtonValue = true;
// Add the button column to the control.
dataGridView1.Columns.Insert(0, buttonColumn);
}
Private Sub CreateUnboundButtonColumn()
' Initialize the button column.
Dim buttonColumn As New DataGridViewButtonColumn
With buttonColumn
.HeaderText = "Details"
.Name = "Details"
.Text = "View Details"
' Use the Text property for the button text for all cells rather
' than using each cell's value as the text for its own button.
.UseColumnTextForButtonValue = True
End With
' Add the button column to the control.
dataGridView1.Columns.Insert(0, buttonColumn)
End Sub
