DataGridViewColumnCollection.AddRange(DataGridViewColumn[]) Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

DataGridViewColumnCollection.cs

Přidá do kolekce oblast sloupců.

public:
 virtual void AddRange(... cli::array <System::Windows::Forms::DataGridViewColumn ^> ^ dataGridViewColumns);

public virtual void AddRange(params System.Windows.Forms.DataGridViewColumn[] dataGridViewColumns);

abstract member AddRange : System.Windows.Forms.DataGridViewColumn[] -> unit
override this.AddRange : System.Windows.Forms.DataGridViewColumn[] -> unit

Public Overridable Sub AddRange (ParamArray dataGridViewColumns As DataGridViewColumn())

Parametry

dataGridViewColumns

DataGridViewColumn[]

Pole DataGridViewColumn objektů, které chcete přidat.

Výjimky

ArgumentNullException

dataGridViewColumns je null.

InvalidOperationException

Přidružený DataGridView ovládací prvek provádí jednu z následujících akcí, které dočasně brání přidání nových sloupců:

• Výběr všech buněk v ovládacím prvku

• Vymazání výběru.

• Aktualizace hodnot vlastností sloupce DisplayIndex

nebo

Tato metoda se volá z obslužné rutiny pro jednu z následujících DataGridView událostí:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

nebo

Alespoň jedna z hodnot v dataGridViewColumns hodnotě je null.

nebo

Alespoň jeden ze sloupců v dataGridViewColumns ovládacím DataGridView prvku již patří.

nebo

Nejméně jeden ze sloupců má dataGridViewColumnsCellType hodnotu null vlastnosti a DataGridView ovládací prvek obsahuje aspoň jeden řádek.

nebo

Nejméně jeden ze sloupců má dataGridViewColumnsSortMode hodnotu Automatic vlastnosti a SelectionMode hodnota vlastnosti je FullColumnSelect nebo ColumnHeaderSelect. Pomocí ovládacího prvku ISupportInitialize.BeginInit() a ISupportInitialize.EndInit() metod dočasně nastavte konfliktní hodnoty vlastností.

nebo

Nejméně jeden ze sloupců v dataGridViewColumns má InheritedAutoSizeMode hodnotu ColumnHeader vlastnosti a ColumnHeadersVisible hodnota vlastnosti je false.

nebo

Nejméně jeden ze sloupců v dataGridViewColumns má InheritedAutoSizeMode hodnotu Fill vlastnosti a Frozen hodnotu truevlastnosti .

nebo

Sloupce mají dataGridViewColumnsFillWeight hodnoty vlastností, které by způsobily, že kombinované FillWeight hodnoty všech sloupců v ovládacím prvku překročí 65535.

nebo

Nejméně dvě hodnoty jsou dataGridViewColumns odkazy na stejné DataGridViewColumn.

nebo

Alespoň jeden ze sloupců v dataGridViewColumns má DisplayIndex a Frozen hodnoty vlastností, které by se zobrazily mezi sadou sousedních sloupců s opačnou Frozen hodnotou vlastnosti.

Příklady

Následující příklad kódu ukazuje použití této metody. Tento příklad je součástí většího příkladu dostupného v části Postupy: Nastavení režimů velikosti ovládacího prvku model Windows Forms DataGridView.

dataGridView1.Columns.AddRange(new DataGridViewTextBoxColumn[] { 
    idColumn, titleColumn, subTitleColumn, 
    summaryColumn, contentColumn });
dataGridView1.Rows.Add(new String[] { "1", 
    "A Short Title", "A Longer SubTitle", 
    "A short description of the main point.", 
    "The full contents of the topic, with detailed examples." });

dataGridView1.Columns.AddRange(New DataGridViewTextBoxColumn() { _
    idColumn, titleColumn, subTitleColumn, _
    summaryColumn, contentColumn})
dataGridView1.Rows.Add(New String() {"1", _
    "A Short Title", "A Longer SubTitle", _
    "A short description of the main point.", _
    "The full contents of the topic, with detailed examples."})

Viz také

• DataGridView
• DataGridViewColumn