DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) Metod

Definition

Namnområde:
System.Windows.Forms
Sammansättning:
System.Windows.Forms.dll
Källa:
DataGridViewColumnCollection.cs
Källa:
DataGridViewColumnCollection.cs
Källa:
DataGridViewColumnCollection.cs
Källa:
DataGridViewColumnCollection.cs
Källa:
DataGridViewColumnCollection.cs

Infogar en kolumn vid det angivna indexet i samlingen.

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)

Parametrar

columnIndex
Int32

Det nollbaserade index där den angivna kolumnen ska infogas.

dataGridViewColumn
DataGridViewColumn

Infoga DataGridViewColumn .

Undantag

ArgumentNullException

dataGridViewColumn är null.

InvalidOperationException

Den associerade DataGridView kontrollen utför någon av följande åtgärder som tillfälligt förhindrar att nya kolumner läggs till:

  • Markera alla celler i kontrollen.

  • Rensa markeringen.

  • Uppdaterar kolumnegenskapsvärden DisplayIndex .

-eller-

Den här metoden anropas från en hanterare för någon av följande DataGridView händelser:

-eller-

dataGridViewColumn tillhör redan en DataGridView kontroll.

-eller-

Egenskapsvärdet dataGridViewColumnSortMode är Automatic och egenskapsvärdet SelectionMode är FullColumnSelect eller ColumnHeaderSelect. Använd kontrollen ISupportInitialize.BeginInit() och ISupportInitialize.EndInit() metoderna för att tillfälligt ange motstridiga egenskapsvärden.

-eller-

Egenskapsvärdet dataGridViewColumnInheritedAutoSizeMode är ColumnHeader och egenskapsvärdet ColumnHeadersVisible är false.

-eller-

dataGridViewColumn har ett InheritedAutoSizeMode egenskapsvärde och Fill ett Frozen egenskapsvärde på true.

-eller-

dataGridViewColumn har DisplayIndex och Frozen egenskapsvärden som visar den bland en uppsättning intilliggande kolumner med det motsatta Frozen egenskapsvärdet.

-eller-

Kontrollen DataGridView innehåller minst en rad och dataGridViewColumn har ett CellType egenskapsvärde på null.

Exempel

Följande kodexempel illustrerar användningen av den här metoden. Mer information finns i 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

Gäller för

Se även