DataGridViewRowCollection.Add Yöntem

Tanım

Koleksiyona bir veya daha fazla satır ekler.

Aşırı Yüklemeler

Add()

Koleksiyona yeni bir satır ekler.

Add(Int32)

Belirtilen sayıda yeni satırı koleksiyona ekler.

Add(Object[])

Koleksiyona yeni bir satır ekler ve hücreleri belirtilen nesnelerle doldurur.

Add(DataGridViewRow)

Belirtilen DataGridViewRow öğesini koleksiyona ekler.

Add()

Kaynak:
DataGridViewRowCollection.cs
Kaynak:
DataGridViewRowCollection.cs
Kaynak:
DataGridViewRowCollection.cs

Koleksiyona yeni bir satır ekler.

C#
public virtual int Add();

Döndürülenler

Yeni satırın dizini.

Özel durumlar

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

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

-veya-

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

-veya-

sütun DataGridView içermiyor.

-veya-

Bu işlem, çözülmemiş satırların ardından dondurulmuş bir satır ekler.

özelliği tarafından döndürülen satır, RowTemplate denetimdeki sütunlardan daha fazla hücreye sahip.

Açıklamalar

Aşırı yükleme, Add() öğesini temel alan RowTemplateDataGridViewsatırlar ekler. Mümkünse yeni satır paylaşılır. En iyi ölçeklenebilirlik için özelliğinde belirtilen satırın RowTemplate paylaşılabildiğinden emin olun. 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ında 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.

Ayrıca bkz.

Şunlara uygulanır

.NET Framework 4.8.1 ve diğer sürümler
Ürün Sürümler
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

Add(Int32)

Kaynak:
DataGridViewRowCollection.cs
Kaynak:
DataGridViewRowCollection.cs
Kaynak:
DataGridViewRowCollection.cs

Belirtilen sayıda yeni satırı koleksiyona ekler.

C#
public virtual int Add(int count);

Parametreler

count
Int32

öğesine eklenecek DataGridViewRowCollectionsatır sayısı.

Döndürülenler

Eklenen son satırın dizini.

Özel durumlar

count 1'den küçüktür.

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

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

-veya-

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

-veya-

sütun DataGridView içermiyor.

-veya-

özelliği tarafından döndürülen satır, RowTemplate denetimdeki sütunlardan daha fazla hücreye sahip.

-veya-

Bu işlem, dondurulmamış satırların ardından dondurulmuş satırlar ekler.

Açıklamalar

yöntemi paylaşılan Add(Int32) satırları öğesine DataGridViewRowCollectionekler. Yeni satırlar öğesini temel DataGridViewalırRowTemplate. En iyi ölçeklenebilirlik için özelliğinde belirtilen satırın RowTemplate paylaşılabildiğinden emin olun. 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ında 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.

Ayrıca bkz.

Şunlara uygulanır

.NET Framework 4.8.1 ve diğer sürümler
Ürün Sürümler
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

Add(Object[])

Kaynak:
DataGridViewRowCollection.cs
Kaynak:
DataGridViewRowCollection.cs
Kaynak:
DataGridViewRowCollection.cs

Koleksiyona yeni bir satır ekler ve hücreleri belirtilen nesnelerle doldurur.

C#
public virtual int Add(params object[] values);

Parametreler

values
Object[]

Yeni DataGridViewRowöğesinin hücrelerini dolduran değişken sayıda nesne.

Döndürülenler

Yeni satırın dizini.

Özel durumlar

values, null değeridir.

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

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

-veya-

VirtualMode özelliğinin DataGridView özelliği olarak trueayarlanır.

-veya-

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

-veya-

sütun DataGridView içermiyor.

-veya-

özelliği tarafından döndürülen satır, RowTemplate denetimdeki sütunlardan daha fazla hücreye sahip.

-veya-

Bu işlem, çözülmemiş satırların ardından dondurulmuş bir satır ekler.

Açıklamalar

yöntemi, Add(Object[]) öğesine paylaşılmayan bir satır DataGridViewRowCollectionekler. 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ında 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.

Ayrıca bkz.

Şunlara uygulanır

.NET Framework 4.8.1 ve diğer sürümler
Ürün Sürümler
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

Add(DataGridViewRow)

Kaynak:
DataGridViewRowCollection.cs
Kaynak:
DataGridViewRowCollection.cs
Kaynak:
DataGridViewRowCollection.cs

Belirtilen DataGridViewRow öğesini koleksiyona ekler.

C#
public virtual int Add(System.Windows.Forms.DataGridViewRow dataGridViewRow);

Parametreler

dataGridViewRow
DataGridViewRow

DataGridViewRow öğesine eklenecek öğesini seçinDataGridViewRowCollection.

Döndürülenler

Yeni DataGridViewRowöğesinin dizini.

Özel durumlar

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

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

-veya-

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

-veya-

sütun DataGridView içermiyor.

-veya-

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

-veya-

dataGridViewRow Selected özelliği değerine truesahiptir.

-veya-

Bu işlem, çözülmemiş satırların ardından dondurulmuş bir satır ekler.

dataGridViewRow, null değeridir.

dataGridViewRow denetimdeki sütunlardan daha fazla hücreye sahiptir.

Açıklamalar

yöntemi, Add(DataGridViewRow) mümkünse öğesine paylaşılan bir satır DataGridViewRowCollectionekler. Aksi takdirde, yeni satır 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ında 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.

Ayrıca bkz.

Şunlara uygulanır

.NET Framework 4.8.1 ve diğer sürümler
Ürün Sürümler
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10