DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Vloží sloupec do daného indexu 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, do kterého se má vložit daný sloupec.

dataGridViewColumn

DataGridViewColumn

Instance DataGridViewColumn, která má být vložena.

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

• Vymaže se výběr.

• Aktualizují se hodnoty 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ří k ovládacímu prvku DataGridView .

-nebo-

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

-nebo-

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

-nebo-

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

-nebo-

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

-nebo-

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

Příklady

Následující příklad kódu znázorňuje použití této metody. Další informace najdete v tématu Postupy: 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