DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) Méthode

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Source:
DataGridViewColumnCollection.cs
Source:
DataGridViewColumnCollection.cs
Source:
DataGridViewColumnCollection.cs
Source:
DataGridViewColumnCollection.cs
Source:
DataGridViewColumnCollection.cs

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 auquel insérer la colonne donnée.

dataGridViewColumn
DataGridViewColumn

À DataGridViewColumn insérer.

Exceptions

ArgumentNullException

dataGridViewColumn a la valeur null.

InvalidOperationException

Le contrôle associé DataGridView effectue l’une des actions suivantes qui empêchent temporairement l’ajout de nouvelles colonnes :

  • Sélection de toutes les cellules du contrôle.

  • Effacement de la sélection.

  • Mise à jour des valeurs de propriété de colonne DisplayIndex .

- ou -

Cette méthode est appelée à partir d’un gestionnaire pour l’un des événements suivants DataGridView :

- ou -

dataGridViewColumn appartient déjà à un DataGridView contrôle.

- ou -

La dataGridViewColumnSortMode valeur de la propriété est Automatic et la valeur de SelectionMode la propriété est FullColumnSelect ou ColumnHeaderSelect. Utilisez le contrôle ISupportInitialize.BeginInit() et ISupportInitialize.EndInit() les méthodes pour définir temporairement les valeurs de propriété en conflit.

- ou -

La valeur de dataGridViewColumnInheritedAutoSizeMode la propriété est ColumnHeader et la valeur de la ColumnHeadersVisible propriété est false.

- ou -

dataGridViewColumn a une InheritedAutoSizeMode valeur de propriété et Fill une Frozen valeur de propriété de true.

- ou -

dataGridViewColumn a DisplayIndex et Frozen les valeurs de propriété qui l’affichent parmi un ensemble de colonnes adjacentes avec la valeur de propriété opposée Frozen .

- ou -

Le DataGridView contrôle contient au moins une ligne et dataGridViewColumn a une CellType valeur de propriété .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 à

Voir aussi