DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

DataGridViewColumnCollection.cs

Koleksiyondaki belirtilen dizine bir sütun ekler.

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)

Parametreler

columnIndex

Int32

Verilen sütunun eklendiği sıfır tabanlı dizin.

dataGridViewColumn

DataGridViewColumn

DataGridViewColumn Eklenecek öğe.

Özel durumlar

ArgumentNullException

dataGridViewColumn, null'e eşittir.

InvalidOperationException

İlişkili DataGridView denetim, yeni sütunların eklenmesini geçici olarak engelleyen aşağıdaki eylemlerden birini gerçekleştirmektedir:

• Denetimdeki tüm hücreleri seçme.

• Seçim temizleniyor.

• Sütun DisplayIndex özelliği değerleri güncelleştiriliyor.

-veya-

Bu yöntem, aşağıdaki DataGridView olaylardan biri için bir işleyiciden çağrılır:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-veya-

dataGridViewColumn zaten bir DataGridView denetime ait.

-veya-

Özellik dataGridViewColumnSortMode değeri ve AutomaticSelectionMode özellik değeri veya FullColumnSelectşeklindedirColumnHeaderSelect. Çakışan özellik değerlerini geçici olarak ayarlamak için denetimi ISupportInitialize.BeginInit() ve ISupportInitialize.EndInit() yöntemleri kullanın.

-veya-

Özellik dataGridViewColumnInheritedAutoSizeMode değeri, ColumnHeaderColumnHeadersVisible özellik değeri ise şeklindedir false.

-veya-

dataGridViewColumn InheritedAutoSizeMode özelliği değerine Fill ve Frozen özellik değerine truesahiptir.

-veya-

dataGridViewColumn has DisplayIndex and Frozen özellik değerleri, bunu karşı Frozen özellik değerine sahip bir dizi bitişik sütun arasında görüntüleyecek.

-veya-

Denetim DataGridView en az bir satır içerir ve dataGridViewColumn özelliği değerine CellTypesahiptirnull.

Örnekler

Aşağıdaki kod örneğinde bu yöntemin kullanımı gösterilmektedir. Daha fazla bilgi için bkz. H nasıl yapılır: Data-Bound Windows Forms DataGridView Denetimine İlişkisiz Sütun Ekleme.

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

Ayrıca bkz.

• DataGridView
• DataGridViewColumn