DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Inserisce una colonna nell'insieme in corrispondenza dell'indice specificato.

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)

Parametri

columnIndex
Int32

Indice in base zero in corrispondenza del quale inserire la colonna specificata.

dataGridViewColumn
DataGridViewColumn

Oggetto DataGridViewColumn da inserire.

Eccezioni

ArgumentNullException

dataGridViewColumn è null.

InvalidOperationException

Il controllo DataGridView associato sta eseguendo una delle azioni riportate di seguito che impedisce temporaneamente di aggiungere nuove colonne:

  • Selezione di tutte le celle del controllo.

  • Annullamento della selezione.

  • Aggiornamento dei valori della proprietà DisplayIndex della colonna.

-oppure- Questo metodo viene chiamato da un gestore per uno degli eventi di DataGridView seguenti:

-oppure- dataGridViewColumn appartiene già a un controllo DataGridView.

-oppure- Il valore della proprietà SortMode di dataGridViewColumn è Automatic, mentre il valore della proprietà SelectionMode è FullColumnSelect o ColumnHeaderSelect. Utilizzare i metodi ISupportInitialize.BeginInit() e ISupportInitialize.EndInit() del controllo per impostare temporaneamente i valori delle proprietà in conflitto.

-oppure- Il valore della proprietà InheritedAutoSizeMode di dataGridViewColumn è ColumnHeader, mentre il valore della proprietà ColumnHeadersVisible è false.

-oppure- Il valore della proprietà InheritedAutoSizeMode del parametro dataGridViewColumn è Fill mentre il valore della proprietà Frozen è true.

-oppure- Il parametro dataGridViewColumn ha i valori delle proprietà DisplayIndex e Frozen che ne consentono la visualizzazione in un set di colonne adiacenti con il valore della proprietà Frozen opposto.

-oppure- Il controllo DataGridView contiene almeno una riga e il valore della proprietà CellType del parametro dataGridViewColumn è null.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo metodo. Per altre informazioni, vedere Procedura: Aggiungere una colonna non in uscita a un controllo DataGridView Data-Bound Windows Forms.

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

Si applica a

Vedi anche