DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) Метод

Определение

Вставляет в коллекцию столбец по указанному индексу.Inserts a column at the given index in the 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

Параметры

columnIndex
Int32

Отсчитываемый с нуля индекс, по которому должен быть вставлен заданный столбец.The zero-based index at which to insert the given column.

dataGridViewColumn
DataGridViewColumn

Вставляемый объект DataGridViewColumn.The DataGridViewColumn to insert.

Исключения

dataGridViewColumnnull.dataGridViewColumn is null.

Сопоставленный элемент управления DataGridView выполняет одно из следующих действий, временно блокирующих добавление новых столбцов:The associated DataGridView control is performing one of the following actions that temporarily prevents new columns from being added: – выбор всех ячеек элемента управления;- Selecting all cells in the control.

– отмена выбора.- Clearing the selection.

– обновление значений свойств столбца DisplayIndex.- Updating column DisplayIndex property values.

- или --or- Этот метод вызывается из обработчика для одного из следующих событий DataGridView :This method is being called from a handler for one of the following DataGridView events:

- или --or- Столбец dataGridViewColumn уже принадлежит элементу управления DataGridView.dataGridViewColumn already belongs to a DataGridView control.

- или --or- Свойство dataGridViewColumnSortMode имеет значение Automatic, а свойство SelectionMode имеет значение FullColumnSelect или ColumnHeaderSelect.The dataGridViewColumnSortMode property value is Automatic and the SelectionMode property value is FullColumnSelect or ColumnHeaderSelect. Методы ISupportInitialize.BeginInit() и ISupportInitialize.EndInit() элемента управления позволяет временно задавать конфликтующие значения свойств.Use the control ISupportInitialize.BeginInit() and ISupportInitialize.EndInit() methods to temporarily set conflicting property values.

- или --or- Свойство dataGridViewColumnInheritedAutoSizeMode имеет значение ColumnHeader, а свойство ColumnHeadersVisible имеет значение false.The dataGridViewColumnInheritedAutoSizeMode property value is ColumnHeader and the ColumnHeadersVisible property value is false.

- или --or- Свойство InheritedAutoSizeMode столбца dataGridViewColumn имеет значение Fill, а свойство Frozen — значение true.dataGridViewColumn has an InheritedAutoSizeMode property value of Fill and a Frozen property value of true.

- или --or- В столбце dataGridViewColumn заданы такие значения свойств DisplayIndex и Frozen, в результате которых столбец будет отображаться среди набора смежных столбцов с противоположным значением свойства Frozen.dataGridViewColumn has DisplayIndex and Frozen property values that would display it among a set of adjacent columns with the opposite Frozen property value.

-или--or- Элемент управления DataGridView содержит по крайней мере одну строку, а столбец dataGridViewColumn имеет свойство CellType со значением null.The DataGridView control contains at least one row and dataGridViewColumn has a CellType property value of null.

Примеры

В следующем примере кода показано использование этого метода.The following code example illustrates the use of this method. Дополнительные сведения см. в разделе Практическое руководство. Добавьте Непривязанный столбец к элементу управленияWindows Forms DataGridView с привязкой к данным.For more information, see 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

Применяется к

Дополнительно