DataGridViewRowCollection.Insert 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
Insert(Int32, DataGridViewRow)	Belirtilen DataGridViewRow öğesini koleksiyona ekler.
Insert(Int32, Int32)	Belirtilen konumdaki koleksiyona belirtilen satır sayısını ekler.
Insert(Int32, Object[])	Koleksiyona belirtilen konumda bir satır ekler ve hücreleri belirtilen nesnelerle doldurur.

Insert(Int32, DataGridViewRow)

Kaynak:

DataGridViewRowCollection.cs

Belirtilen DataGridViewRow öğesini koleksiyona ekler.

public:
 virtual void Insert(int rowIndex, System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);

public virtual void Insert(int rowIndex, System.Windows.Forms.DataGridViewRow dataGridViewRow);

abstract member Insert : int * System.Windows.Forms.DataGridViewRow -> unit
override this.Insert : int * System.Windows.Forms.DataGridViewRow -> unit

Public Overridable Sub Insert (rowIndex As Integer, dataGridViewRow As DataGridViewRow)

Parametreler

rowIndex

Int32

Satırın eklendiği konum.

dataGridViewRow

DataGridViewRow

DataGridViewRow içine eklenecek .DataGridViewRowCollection

Özel durumlar

ArgumentOutOfRangeException

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

ArgumentNullException

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

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

-veya-

rowIndex koleksiyondaki satır sayısına eşittir ve AllowUserToAddRows özelliğinin DataGridView değeri olarak trueayarlanır.

-veya-

sütun DataGridView içermiyor.

-veya-

DataGridView özelliği dataGridViewRow değildirnull.

-veya-

dataGridViewRow Selected özelliği değerine truesahiptir.

-veya-

Bu işlem dondurulmamış satırların arkasına dondurulmuş bir satır veya dondurulmamış satırların önüne dondurulmamış bir satır ekler.

ArgumentException

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

Açıklamalar

yöntemi, Insert(Int32, 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

Insert(Int32, Int32)

Kaynak:

DataGridViewRowCollection.cs

Belirtilen konumdaki koleksiyona belirtilen satır sayısını ekler.

public:
 virtual void Insert(int rowIndex, int count);

public virtual void Insert(int rowIndex, int count);

abstract member Insert : int * int -> unit
override this.Insert : int * int -> unit

Public Overridable Sub Insert (rowIndex As Integer, count As Integer)

Parametreler

rowIndex

Int32

Satırların eklendiği konum.

count

Int32

içine DataGridViewRowCollectioneklenecek satır sayısı.

Özel durumlar

ArgumentOutOfRangeException

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

-veya-

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-

rowIndex koleksiyondaki satır sayısına eşittir ve AllowUserToAddRows özelliğinin DataGridView değeri olarak trueayarlanır.

-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 arkasına dondurulmuş bir satır veya dondurulmamış satırların önüne dondurulmamış bir satır ekler.

Açıklamalar

yöntemi, Insert(Int32, Int32) öğ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

Insert(Int32, Object[])

Kaynak:

DataGridViewRowCollection.cs

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

public:
 virtual void Insert(int rowIndex, ... cli::array <System::Object ^> ^ values);

public virtual void Insert(int rowIndex, params object[] values);

abstract member Insert : int * obj[] -> unit
override this.Insert : int * obj[] -> unit

Public Overridable Sub Insert (rowIndex As Integer, ParamArray values As Object())

Parametreler

rowIndex

Int32

Satırın eklendiği konum.

values

Object[]

Yeni satırın hücrelerini dolduran değişken nesne sayısı.

Özel durumlar

ArgumentOutOfRangeException

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

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-

rowIndex koleksiyondaki satır sayısına eşittir ve AllowUserToAddRows özelliğinin DataGridView değeri olarak trueayarlanır.

-veya-

Denetimin DataGridViewRowTemplate özelliği tarafından döndürülen satırın özelliği değildir null.

-veya-

Bu işlem dondurulmamış satırların arkasına dondurulmuş bir satır veya dondurulmamış satırların önüne dondurulmamış bir satır ekler.

ArgumentException

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

Açıklamalar

yöntemi, Insert(Int32, Object[]) öğesine paylaşılmayan DataGridViewRowCollectionbir satır ekler.

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