DataGridViewRowCollection.Add Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Dodaje co najmniej jeden wiersz do kolekcji.

Przeciążenia

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

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óra tymczasowo uniemożliwia dodawanie 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-

Kolumna DataGridView nie zawiera kolumn.

-lub-

Ta operacja spowoduje dodanie zamrożonego wiersza po niezaroś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 udostępniany, 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).

Wiersze w kontrolce nie są automatycznie sortowane po dodaniu nowych wierszy. Aby posortować nowe wiersze w ich prawidłowej pozycji, wywołaj metodę DataGridView.Sort w procedurze obsługi zdarzeń DataGridView.RowsAdded . Można 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 praktyki dotyczące skalowania formantu DataGridView formularzy systemu Windows

Add(Int32)

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óra tymczasowo uniemożliwia dodawanie 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-

Kolumna DataGridView nie zawiera kolumn.

-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 niezarośniętych wierszach.

Uwagi

Metoda Add(Int32) dodaje współużytkowane wiersze do elementu DataGridViewRowCollection. Nowe wiersze są oparte na RowTemplate wartości .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).

Wiersze w kontrolce nie są automatycznie sortowane po dodaniu nowych wierszy. Aby posortować nowe wiersze w ich prawidłowej pozycji, wywołaj metodę DataGridView.Sort w procedurze obsługi zdarzeń DataGridView.RowsAdded . Można 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[])

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

values to null.

InvalidOperationException

Skojarzona DataGridView kontrolka wykonuje jedną z następujących akcji, która tymczasowo uniemożliwia dodawanie 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 właściwości DataGridView jest ustawiona na truewartość .

-lub-

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

-lub-

Kolumna DataGridView nie zawiera kolumn.

-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 niezarośniętych wierszach.

Uwagi

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

Wiersze w kontrolce nie są automatycznie sortowane po dodaniu nowych wierszy. Aby posortować nowe wiersze w ich prawidłowej pozycji, wywołaj metodę DataGridView.Sort w procedurze obsługi zdarzeń DataGridView.RowsAdded . Można 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)

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óra tymczasowo uniemożliwia dodawanie 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-

Kolumna DataGridView nie zawiera kolumn.

-lub-

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

-lub-

dataGridViewRowSelected ma wartość truewłaściwości .

-lub-

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

ArgumentNullException

dataGridViewRow to null.

ArgumentException

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

Uwagi

Metoda Add(DataGridViewRow) dodaje współużytkowany wiersz do elementu DataGridViewRowCollection, 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).

Wiersze w kontrolce nie są automatycznie sortowane po dodaniu nowych wierszy. Aby posortować nowe wiersze w ich prawidłowej pozycji, wywołaj metodę DataGridView.Sort w procedurze obsługi zdarzeń DataGridView.RowsAdded . Można 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 praktyki dotyczące skalowania formantu DataGridView formularzy systemu Windows