DataGridViewRowCollection.Add Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Dodaje jeden lub więcej wierszy do kolekcji.

Przeciążenia

Nazwa	Opis
Add()	Dodaje nowy wiersz do kolekcji.
Add(Int32)	Dodaje określoną liczbę nowych wierszy do kolekcji.
Add(Object[])	Dodaje nowy wiersz do kolekcji i wypełnia komórki określonymi obiektami.
Add(DataGridViewRow)	Dodaje określony DataGridViewRow element do kolekcji.

Add()

Źródło:

DataGridViewRowCollection.cs

Dodaje nowy wiersz do kolekcji.

public:
 virtual int Add();

public virtual int Add();

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

Public Overridable Function Add () As Integer

Zwraca

Int32

Indeks nowego wiersza.

Wyjątki

InvalidOperationException

Skojarzona DataGridView kontrolka wykonuje jedną z następujących akcji, które tymczasowo uniemożliwiają dodanie nowych wierszy:

• Zaznaczanie wszystkich komórek w kontrolce.

• Czyszczenie zaznaczenia.

— lub —

Ta metoda jest wywoływana z programu obsługi dla jednego z następujących DataGridView zdarzeń:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

— lub —

Właściwość DataSource obiektu DataGridView nie nullma wartości .

— lub —

Kolumny DataGridView nie są kolumnami.

— lub —

Ta operacja spowoduje dodanie zamrożonego wiersza po nierozrośniętych wierszach.

ArgumentException

Wiersz zwracany przez RowTemplate właściwość ma więcej komórek niż kolumny w kontrolce.

Uwagi

Przeciążenie Add() dodaje wiersze oparte na RowTemplate obiekcie DataGridView. Nowy wiersz jest współużytkowany, jeśli to możliwe. Upewnij się, że wiersz określony we RowTemplate właściwości może być współużytkowany w celu uzyskania najlepszej skalowalności. Aby uzyskać więcej informacji, zobacz Best Practices for Scaling the Windows Forms DataGridView Control (Najlepsze rozwiązania dotyczące skalowania kontrolki DataGridView formularzy systemu Windows).

Wiersze w kontrolce nie są automatycznie sortowane po dodaniu nowych wierszy. Aby posortować nowe wiersze w prawidłowej pozycji, wywołaj metodę DataGridView.Sort w procedurze obsługi zdarzeń DataGridView.RowsAdded . Możesz również wywołać metodę DataGridView.Sort w procedurze CellValueChanged obsługi zdarzeń, aby posortować wiersze, gdy użytkownik modyfikuje komórkę.

Zobacz też

• DataGridView
• DataGridViewRow
• Najlepsze rozwiązania dotyczące skalowania kontrolki DataGridView formularzy systemu Windows

Add(Int32)

Źródło:

DataGridViewRowCollection.cs

Dodaje określoną liczbę nowych wierszy do kolekcji.

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

Parametry

count

Int32

Liczba wierszy do dodania do elementu DataGridViewRowCollection.

Zwraca

Int32

Indeks ostatniego dodanego wiersza.

Wyjątki

ArgumentOutOfRangeException

count wartość jest mniejsza niż 1.

InvalidOperationException

Skojarzona DataGridView kontrolka wykonuje jedną z następujących akcji, które tymczasowo uniemożliwiają dodanie nowych wierszy:

• Zaznaczanie wszystkich komórek w kontrolce.

• Czyszczenie zaznaczenia.

— lub —

Ta metoda jest wywoływana z programu obsługi dla jednego z następujących DataGridView zdarzeń:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

— lub —

Właściwość DataSource obiektu DataGridView nie nullma wartości .

— lub —

Kolumny DataGridView nie są kolumnami.

— lub —

Wiersz zwracany przez RowTemplate właściwość ma więcej komórek niż kolumny w kontrolce.

— lub —

Ta operacja spowoduje dodanie zamrożonych wierszy po odrośniętych wierszach.

Uwagi

Metoda Add(Int32) dodaje współużytkowane wiersze do elementu DataGridViewRowCollection. Nowe wiersze są oparte na RowTemplate obiekcie DataGridView. Upewnij się, że wiersz określony we RowTemplate właściwości może być współużytkowany w celu uzyskania najlepszej skalowalności. Aby uzyskać więcej informacji, zobacz Best Practices for Scaling the Windows Forms DataGridView Control (Najlepsze rozwiązania dotyczące skalowania kontrolki DataGridView formularzy systemu Windows).

Wiersze w kontrolce nie są automatycznie sortowane po dodaniu nowych wierszy. Aby posortować nowe wiersze w prawidłowej pozycji, wywołaj metodę DataGridView.Sort w procedurze obsługi zdarzeń DataGridView.RowsAdded . Możesz również wywołać metodę DataGridView.Sort w procedurze CellValueChanged obsługi zdarzeń, aby posortować wiersze, gdy użytkownik modyfikuje komórkę.

Zobacz też

• DataGridView
• DataGridViewRow

Add(Object[])

Źródło:

DataGridViewRowCollection.cs

Dodaje nowy wiersz do kolekcji i wypełnia komórki określonymi obiektami.

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

Parametry

values

Object[]

Zmienna liczba obiektów, które wypełniają komórki nowego DataGridViewRowobiektu .

Zwraca

Int32

Indeks nowego wiersza.

Wyjątki

ArgumentNullException

Parametr values ma wartość null.

InvalidOperationException

Skojarzona DataGridView kontrolka wykonuje jedną z następujących akcji, które tymczasowo uniemożliwiają dodanie nowych wierszy:

• Zaznaczanie wszystkich komórek w kontrolce.

• Czyszczenie zaznaczenia.

— lub —

Ta metoda jest wywoływana z programu obsługi dla jednego z następujących DataGridView zdarzeń:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

— lub —

Właściwość VirtualMode elementu DataGridView jest ustawiona na true.

— lub —

Właściwość DataSource obiektu DataGridView nie nullma wartości .

— lub —

Kolumny DataGridView nie są kolumnami.

— lub —

Wiersz zwracany przez RowTemplate właściwość ma więcej komórek niż kolumny w kontrolce.

— lub —

Ta operacja spowoduje dodanie zamrożonego wiersza po nierozrośniętych wierszach.

Uwagi

Metoda Add(Object[]) dodaje nieudostępny wiersz do elementu DataGridViewRowCollection. Aby uzyskać więcej informacji, zobacz Best Practices for Scaling the Windows Forms DataGridView Control (Najlepsze rozwiązania dotyczące skalowania kontrolki DataGridView formularzy systemu Windows).

Wiersze w kontrolce nie są automatycznie sortowane po dodaniu nowych wierszy. Aby posortować nowe wiersze w prawidłowej pozycji, wywołaj metodę DataGridView.Sort w procedurze obsługi zdarzeń DataGridView.RowsAdded . Możesz również wywołać metodę DataGridView.Sort w procedurze CellValueChanged obsługi zdarzeń, aby posortować wiersze, gdy użytkownik modyfikuje komórkę.

Zobacz też

• DataGridView
• DataGridViewRow

Add(DataGridViewRow)

Źródło:

DataGridViewRowCollection.cs

Dodaje określony DataGridViewRow element do kolekcji.

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

Parametry

dataGridViewRow

DataGridViewRow

Element DataGridViewRow do dodania do elementu DataGridViewRowCollection.

Zwraca

Int32

Indeks nowego DataGridViewRowelementu .

Wyjątki

InvalidOperationException

Skojarzona DataGridView kontrolka wykonuje jedną z następujących akcji, które tymczasowo uniemożliwiają dodanie nowych wierszy:

• Zaznaczanie wszystkich komórek w kontrolce.

• Czyszczenie zaznaczenia.

— lub —

Ta metoda jest wywoływana z programu obsługi dla jednego z następujących DataGridView zdarzeń:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

— lub —

Właściwość DataSource obiektu DataGridView nie nullma wartości .

— lub —

Kolumny DataGridView nie są kolumnami.

— lub —

Właściwość DataGridView obiektu dataGridViewRow nie nullma wartości .

— lub —

dataGridViewRow Selected ma wartość truewłaściwości .

— lub —

Ta operacja spowoduje dodanie zamrożonego wiersza po nierozrośniętych wierszach.

ArgumentNullException

Parametr dataGridViewRow ma wartość null.

ArgumentException

dataGridViewRow zawiera więcej komórek niż kolumny w kontrolce.

Uwagi

Metoda Add(DataGridViewRow) dodaje współużytkowany wiersz do DataGridViewRowCollectionelementu , jeśli to możliwe. W przeciwnym razie nowy wiersz jest nieudostępniany. Aby uzyskać więcej informacji, zobacz Best Practices for Scaling the Windows Forms DataGridView Control (Najlepsze rozwiązania dotyczące skalowania kontrolki DataGridView formularzy systemu Windows).

Wiersze w kontrolce nie są automatycznie sortowane po dodaniu nowych wierszy. Aby posortować nowe wiersze w prawidłowej pozycji, wywołaj metodę DataGridView.Sort w procedurze obsługi zdarzeń DataGridView.RowsAdded . Możesz również wywołać metodę DataGridView.Sort w procedurze CellValueChanged obsługi zdarzeń, aby posortować wiersze, gdy użytkownik modyfikuje komórkę.

Zobacz też

• DataGridView
• DataGridViewRow
• DataGridViewColumn
• CellTemplate
• Najlepsze rozwiązania dotyczące skalowania kontrolki DataGridView formularzy systemu Windows