DataGridViewRowCollection.Add Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Koleksiyona bir veya daha fazla satır ekler.

Aşırı Yüklemeler

Name	Description
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 değerini koleksiyona ekler.

Add()

Kaynak:

DataGridViewRowCollection.cs

Koleksiyona yeni bir satır ekler.

public:
 virtual int Add();

public virtual int Add();

abstract member Add : unit -> int
override this.Add : unit -> int

Public Overridable Function Add () As Integer

Döndürülenler

Int32

Yeni satırın dizini.

Özel durumlar

InvalidOperationException

İ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çim temizleniyor.

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

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

-veya-

sütun DataGridView içermiyor.

-veya-

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

ArgumentException

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

Açıklamalar

Aşırı yükleme, Add() öğesini temel alan RowTemplateDataGridViewsatırlar ekler. Yeni satır mümkünse 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ı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.

Ayrıca bkz.

• DataGridView
• DataGridViewRow
• Windows Forms DataGridView Denetimini Ölçeklendirmek için En İyi Yöntemler

Add(Int32)

Kaynak:

DataGridViewRowCollection.cs

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

public:
 virtual int Add(int count);

public virtual int Add(int count);

abstract member Add : int -> int
override this.Add : int -> int

Public Overridable Function Add (count As Integer) As Integer

Parametreler

count

Int32

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

Döndürülenler

Int32

Eklenen son satırın dizini.

Özel durumlar

ArgumentOutOfRangeException

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

InvalidOperationException

İ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çim temizleniyor.

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

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 denetimde sütun bulunandan daha fazla hücreye sahip.

-veya-

Bu işlem, dondurulmamış satırlar sonrasında 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ı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.

Ayrıca bkz.

• DataGridView
• DataGridViewRow

Add(Object[])

Kaynak:

DataGridViewRowCollection.cs

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

public:
 virtual int Add(... cli::array <System::Object ^> ^ values);

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

abstract member Add : obj[] -> int
override this.Add : obj[] -> int

Public Overridable Function Add (ParamArray values As Object()) As Integer

Parametreler

values

Object[]

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

Döndürülenler

Int32

Yeni satırın dizini.

Özel durumlar

ArgumentNullException

values, null'e eşittir.

InvalidOperationException

İ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çim temizleniyor.

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

VirtualMode özelliği DataGridView 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 denetimde sütun bulunandan daha fazla hücreye sahip.

-veya-

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

Açıklamalar

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

Ayrıca bkz.

• DataGridView
• DataGridViewRow

Add(DataGridViewRow)

Kaynak:

DataGridViewRowCollection.cs

Belirtilen DataGridViewRow değerini koleksiyona ekler.

public:
 virtual int Add(System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);

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

abstract member Add : System.Windows.Forms.DataGridViewRow -> int
override this.Add : System.Windows.Forms.DataGridViewRow -> int

Public Overridable Function Add (dataGridViewRow As DataGridViewRow) As Integer

Parametreler

dataGridViewRow

DataGridViewRow

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

Döndürülenler

Int32

Yeni DataGridViewRowöğesinin dizini.

Özel durumlar

InvalidOperationException

İ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çim temizleniyor.

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

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, dondurulmamış satırların ardından dondurulmuş bir satır ekler.

ArgumentNullException

dataGridViewRow, null'e eşittir.

ArgumentException

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

Ayrıca bkz.

• DataGridView
• DataGridViewRow
• DataGridViewColumn
• CellTemplate
• Windows Forms DataGridView Denetimini Ölçeklendirmek için En İyi Yöntemler