DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) Méthode

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Insère une colonne à l'index donné dans la collection.

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)

Paramètres

columnIndex: Int32

Index de base zéro au niveau duquel insérer la colonne donnée.

dataGridViewColumn: DataGridViewColumn

DataGridViewColumn à insérer.

Exceptions

ArgumentNullException

dataGridViewColumn a la valeur null.

InvalidOperationException

Le contrôle DataGridView associé exécute l'une des opérations suivantes qui empêchent temporairement l'ajout de nouvelles colonnes :

Sélection de toutes les cellules contenues dans le contrôle.
Effacement de la sélection.
Mise à jour des valeurs de propriété DisplayIndex de la colonne.
ou - Cette méthode est appelée à partir d’un gestionnaire d’un des événements DataGridView suivants :
CellEnter
CellLeave
CellValidating
CellValidated
RowEnter
RowLeave
RowValidated
RowValidating
ou - dataGridViewColumn appartient déjà à un contrôle DataGridView.
ou - La valeur de propriété dataGridViewColumnSortMode est Automatic et la valeur de propriété SelectionMode est FullColumnSelect ou ColumnHeaderSelect. Utilisez les méthodes ISupportInitialize.BeginInit() et ISupportInitialize.EndInit() du contrôle pour définir temporairement des valeurs de propriétés en conflit.
ou - La valeur de propriété dataGridViewColumnInheritedAutoSizeMode est ColumnHeader et la valeur de propriété ColumnHeadersVisible est false.
ou - dataGridViewColumn a une valeur de propriété InheritedAutoSizeMode de Fill et une valeur de propriété Frozen de true.
ou - dataGridViewColumn a des valeurs de propriété DisplayIndex et Frozen qui l'afficheraient parmi un jeu de colonnes adjacentes avec la valeur de propriété Frozen opposée.
ou - Le contrôle DataGridView contient au moins une ligne et dataGridViewColumn a une valeur de propriété CellType de null.

Exemples

L’exemple de code suivant illustre l’utilisation de cette méthode. Pour plus d’informations, consultez 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

S’applique à

Partager via