DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Inserta una columna en el índice especificado en 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 -> unit

Public Overridable Sub Insert (columnIndex As Integer, dataGridViewColumn As DataGridViewColumn)

Parámetros

columnIndex

Int32

El índice de base cero donde se inserta la columna especificada.

dataGridViewColumn

DataGridViewColumn

DataGridViewColumn que se va a insertar.

Excepciones

ArgumentNullException

dataGridViewColumn es null.

InvalidOperationException

El control DataGridView asociado está realizando una de las acciones siguientes que impide temporalmente que se agreguen nuevas columnas:

• Seleccionar 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 siguientes eventos DataGridView:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

o bien

dataGridViewColumn ya pertenece a un control DataGridView.

o bien

El valor de propiedad dataGridViewColumnSortMode es Automatic y el valor de propiedad SelectionMode es FullColumnSelect o ColumnHeaderSelect. Utilice los métodos ISupportInitialize.BeginInit() y ISupportInitialize.EndInit() del control para establecer temporalmente los valores de propiedades que entren en conflicto.

o bien

El valor de propiedad dataGridViewColumnInheritedAutoSizeMode es ColumnHeader y el valor de propiedad ColumnHeadersVisible es false.

o bien

dataGridViewColumn tiene un valor de InheritedAutoSizeMode para la propiedad Fill y un valor de true para la propiedad Frozen.

o bien

dataGridViewColumn tiene unos valores de las propiedades DisplayIndex y Frozen que lo mostrarían entre un conjunto de columnas adyacentes con el valor contrario de la propiedad Frozen.

o bien

El control DataGridView contiene una fila por lo menos y dataGridViewColumn tiene un valor null para la propiedad CellType.

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

Consulte también

• DataGridView
• DataGridViewColumn