DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

DataGridViewColumnCollection.cs

Vloží sloupec na daný index v kolekci.

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)

Parametry

columnIndex

Int32

Index založený na nule, na který chcete vložit daný sloupec.

dataGridViewColumn

DataGridViewColumn

Vložte DataGridViewColumn ho.

Výjimky

ArgumentNullException

dataGridViewColumn je null.

InvalidOperationException

Přidružený DataGridView ovládací prvek provádí jednu z následujících akcí, které dočasně brání přidání nových sloupců:

• Výběr všech buněk v ovládacím prvku

• Vymazání výběru.

• Aktualizace hodnot vlastností sloupce DisplayIndex

nebo

Tato metoda se volá z obslužné rutiny pro jednu z následujících DataGridView událostí:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

nebo

dataGridViewColumn již patří do DataGridView ovládacího prvku.

nebo

Hodnota dataGridViewColumnSortMode vlastnosti je Automatic a SelectionMode hodnota vlastnosti je FullColumnSelect nebo ColumnHeaderSelect. Pomocí ovládacího prvku ISupportInitialize.BeginInit() a ISupportInitialize.EndInit() metod dočasně nastavte konfliktní hodnoty vlastností.

nebo

Hodnota dataGridViewColumnInheritedAutoSizeMode vlastnosti je ColumnHeader a ColumnHeadersVisible hodnota vlastnosti je false.

nebo

dataGridViewColumn InheritedAutoSizeMode má hodnotu Fill vlastnosti a Frozen hodnotu truevlastnosti .

nebo

dataGridViewColumn obsahuje DisplayIndex hodnoty vlastností Frozen , které by se zobrazily mezi sadou sousedních sloupců s opačnou Frozen hodnotou vlastnosti.

nebo

Ovládací DataGridView prvek obsahuje alespoň jeden řádek a dataGridViewColumn má CellType hodnotu nullvlastnosti .

Příklady

Následující příklad kódu ukazuje použití této metody. Další informace najdete v tématu : Přidání nevázaného sloupce do ovládacího prvku Data-Bound model Windows Forms DataGridView.

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

Viz také

• DataGridView
• DataGridViewColumn