DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Wstawia kolumnę w danym indeksie w kolekcji.

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

Indeks oparty na zerze, w którym ma być wstawiona dana kolumna.

dataGridViewColumn
DataGridViewColumn

Obiekt DataGridViewColumn do wstawienia.

Wyjątki

ArgumentNullException

dataGridViewColumn to null.

InvalidOperationException

Skojarzona DataGridView kontrolka wykonuje jedną z następujących akcji, która tymczasowo uniemożliwia dodawanie nowych kolumn:

  • Zaznaczanie wszystkich komórek w kontrolce.

  • Czyszczenie zaznaczenia.

  • Aktualizowanie wartości właściwości kolumny DisplayIndex .

-lub-

Ta metoda jest wywoływana z programu obsługi dla jednego z następujących DataGridView zdarzeń:

-lub-

dataGridViewColumn już należy do kontrolki DataGridView .

-lub-

Wartość dataGridViewColumnSortMode właściwości to Automatic , a SelectionMode wartość właściwości to FullColumnSelect lub ColumnHeaderSelect. Użyj kontrolki ISupportInitialize.BeginInit() i ISupportInitialize.EndInit() metod, aby tymczasowo ustawić wartości właściwości powodujących konflikt.

-lub-

Wartość dataGridViewColumnInheritedAutoSizeMode właściwości to ColumnHeader , a ColumnHeadersVisible wartość właściwości to false.

-lub-

dataGridViewColumnInheritedAutoSizeMode ma wartość Fill właściwości i Frozen wartość właściwości .true

-lub-

dataGridViewColumn właściwość ma DisplayIndex i Frozen wartości właściwości, które wyświetlałyby je wśród zestawu sąsiednich kolumn z przeciwną Frozen wartością właściwości.

-lub-

Kontrolka DataGridView zawiera co najmniej jeden wiersz i dataGridViewColumn ma CellType wartość nullwłaściwości .

Przykłady

Poniższy przykład kodu ilustruje użycie tej metody. Aby uzyskać więcej informacji, zobacz How to: Add an Unbound Column to a Data-Bound Windows Forms DataGridView Control (Instrukcje: dodawanie niezwiązanej kolumny do kontrolki 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

Dotyczy

Zobacz też