DataGridViewColumnCollection.AddRange(DataGridViewColumn[]) Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

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

• Vymažte výběr.

• 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- Alespoň jeden ze sloupců má dataGridViewColumns CellType hodnotu null vlastnosti a DataGridView ovládací prvek obsahuje aspoň jeden řádek.

-nebo- Nejméně jeden ze sloupců v dataGridViewColumns má SortMode hodnotu Automatic vlastnosti a SelectionMode hodnota vlastnosti je FullColumnSelect nebo ColumnHeaderSelect. Ovládací prvek ISupportInitialize.BeginInit() a ISupportInitialize.EndInit() metody slouží k dočasnému nastavení konfliktních hodnot 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í dataGridViewColumns FillWeight 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 stejnou DataGridViewColumnhodnotu .

-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, který je k dispozici 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