DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Forms
Bütünleştirilmiş Kod:
System.Windows.Forms.dll

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

Eklenecek DataGridViewColumn öğesi.

Özel durumlar

ArgumentNullException

dataGridViewColumn, null değeridir.

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çimi temizleme.

  • 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:

-veya-

dataGridViewColumn zaten bir DataGridView denetime ait.

-veya-

Özellik dataGridViewColumnSortMode değeri ve AutomaticSelectionMode özellik değeri veya ColumnHeaderSelectşeklindedirFullColumnSelect. Ç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ğine Fill ve Frozen özellik değerine truesahiptir.

-veya-

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

-veya-

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

Örnekler

Aşağıdaki kod örneği bu yöntemin kullanımını göstermektedir. Daha fazla bilgi için bkz. 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

Şunlara uygulanır

Ayrıca bkz.