DataGridViewRowCollection.InsertRange(Int32, DataGridViewRow[]) Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

DataGridViewRow Nesneleri belirtilen konumdaki koleksiyona ekler.

public:
 virtual void InsertRange(int rowIndex, ... cli::array <System::Windows::Forms::DataGridViewRow ^> ^ dataGridViewRows);

public virtual void InsertRange (int rowIndex, params System.Windows.Forms.DataGridViewRow[] dataGridViewRows);

abstract member InsertRange : int * System.Windows.Forms.DataGridViewRow[] -> unit
override this.InsertRange : int * System.Windows.Forms.DataGridViewRow[] -> unit

Public Overridable Sub InsertRange (rowIndex As Integer, ParamArray dataGridViewRows As DataGridViewRow())

Parametreler

rowIndex

Int32

Satırların eklendiği konum.

dataGridViewRows

DataGridViewRow[]

öğesine eklenecek DataGridViewRowCollectionnesne dizisiDataGridViewRow.

Özel durumlar

ArgumentNullException

dataGridViewRows, null değeridir.

ArgumentOutOfRangeException

rowIndex sıfırdan küçük veya koleksiyondaki satır sayısından büyük.

ArgumentException

dataGridViewRows yalnızca bir satır içerir ve içerdiği satırda denetimdeki sütunlardan daha fazla hücre vardır.

InvalidOperationException

İlişkili DataGridView denetim, yeni satırların eklenmesini geçici olarak engelleyen aşağıdaki eylemlerden birini gerçekleştiriyor:

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

• Seçimi temizleme.

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

rowIndex koleksiyondaki satır sayısına eşittir ve AllowUserToAddRows şeklindedir true.

-veya-

DataSource özelliğinin DataGridView özelliği değildirnull.

-veya-

Dizideki dataGridViewRows en az bir giriş şeklindedir null.

-veya-

sütun DataGridView içermiyor.

-veya-

Dizideki en az bir satırın dataGridViewRows olmayan nullbir DataGridView özellik değeri vardır.

-veya-

Dizideki en az bir satırın dataGridViewRows özellik değeri vardırtrue.Selected

-veya-

Dizideki dataGridViewRows iki veya daha fazla satır aynı.

-veya-

Dizideki dataGridViewRows en az bir satır, denetimdeki ilgili sütunun türüyle uyumlu olmayan türde bir veya daha fazla hücre içerir.

-veya-

Dizideki dataGridViewRows en az bir satır, denetimdeki sütunlardan daha fazla hücre içeriyor.

-veya-

Bu işlem dondurulmamış satırların arkasına dondurulmuş satırlar ekler veya dondurulmamış satırların önüne satırların dondurulmalarını sağlar.

Örnekler

Aşağıdaki kod örneği, Açıklamalar bölümünde belirtilen hataya geçici bir çözüm olarak seçili satırların önüne satır eklemek için yönteminin nasıl kullanılacağını InsertRange gösterir.

// Workaround for bug that prevents DataGridViewRowCollection.InsertRange
// from working when any rows before the insertion index are selected.
private void InsertRows(int index, params DataGridViewRow[] rows)
{
    System.Collections.Generic.List<int> selectedIndexes =
        new System.Collections.Generic.List<int>();
    foreach (DataGridViewRow row in dataGridView1.SelectedRows)
    {
        if (row.Index >= index)
        {
            selectedIndexes.Add(row.Index);
            row.Selected = false;
        }
    }
    dataGridView1.Rows.InsertRange(index, rows);
    foreach (int selectedIndex in selectedIndexes)
    {
        dataGridView1.Rows[selectedIndex].Selected = true;
    }
}

' Workaround for bug that prevents DataGridViewRowCollection.InsertRange
' from working when any rows before the insertion index are selected.
Private Sub InsertRows(ByVal index As Integer, _
    ByVal ParamArray rows As DataGridViewRow())

    Dim selectedIndexes As New System.Collections.Generic.List(Of Integer)

    For Each row As DataGridViewRow In dataGridView1.SelectedRows
        If row.Index >= index Then
            selectedIndexes.Add(row.Index)
            row.Selected = False
        End If
    Next row

    dataGridView1.Rows.InsertRange(index, rows)

    For Each selectedIndex As Integer In selectedIndexes
        dataGridView1.Rows(selectedIndex).Selected = True
    Next selectedIndex

End Sub

Açıklamalar

yöntemi, InsertRange mümkünse öğesine paylaşılan satırlar DataGridViewRowCollectionekler. Aksi takdirde, yeni satırlar paylaşılmaz. Daha fazla bilgi için bkz. Windows Forms DataGridView Denetimini Ölçeklendirmeye Yönelik En İyi Yöntemler.

Denetimdeki satırlar, yeni satırlar eklendiğinde otomatik olarak sıralanmaz. Yeni satırları doğru konumlarına sıralamak için bir olay işleyicisinde DataGridView.RowsAdded yöntemini çağırınDataGridView.Sort. Kullanıcı bir CellValueChanged hücreyi DataGridView.Sort değiştirdiğinde satırları sıralamak için bir olay işleyicisinde yöntemini çağırmak da isteyebilirsiniz.

Önemli

Bir hata nedeniyle yöntemi, dizin değerinden InsertRange büyük olan satırlar seçiliyse uygulamanızın yanıt vermemeye devam etmelerini rowIndex sağlar. Bu hatayı geçici olarak çözmek için, bu yöntemi çağırmadan önce bu satırların seçimini iptal etmeniz ve daha sonra satırları yeniden seçmelisiniz. Daha fazla bilgi için bu konudaki kod örneğine bakın.

Ayrıca bkz.

• DataGridView
• DataGridViewRow
• AddRange(DataGridViewRow[])