DataGridViewColumnCollection.AddRange(DataGridViewColumn[]) Methode

Definitie

Naamruimte:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Bron:
DataGridViewColumnCollection.cs
Bron:
DataGridViewColumnCollection.cs
Bron:
DataGridViewColumnCollection.cs
Bron:
DataGridViewColumnCollection.cs
Bron:
DataGridViewColumnCollection.cs

Hiermee voegt u een bereik van kolommen toe aan de verzameling.

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

Parameters

dataGridViewColumns
DataGridViewColumn[]

Een matrix met DataGridViewColumn objecten die moeten worden toegevoegd.

Uitzonderingen

ArgumentNullException

dataGridViewColumns is null.

InvalidOperationException

Het bijbehorende DataGridView besturingselement voert een van de volgende acties uit waarmee tijdelijk wordt voorkomen dat nieuwe kolommen worden toegevoegd:

  • Alle cellen in het besturingselement selecteren.

  • De selectie wissen.

  • DisplayIndex Kolomeigenschapswaarden bijwerken.

– of –

Deze methode wordt aangeroepen vanuit een handler voor een van de volgende DataGridView gebeurtenissen:

– of –

Ten minste één van de waarden in dataGridViewColumns is null.

– of –

Ten minste één van de kolommen in dataGridViewColumns behoort al tot een DataGridView besturingselement.

– of –

Ten minste één van de kolommen heeft dataGridViewColumns een CellType eigenschapswaarde en null het DataGridView besturingselement bevat ten minste één rij.

– of –

Ten minste één van de kolommen bevat dataGridViewColumns een SortMode eigenschapswaarde van Automatic en de SelectionMode eigenschapswaarde is FullColumnSelect of ColumnHeaderSelect. Gebruik het besturingselement ISupportInitialize.BeginInit() en ISupportInitialize.EndInit() de methoden om tijdelijk conflicterende eigenschapswaarden in te stellen.

– of –

Ten minste één van de kolommen heeft dataGridViewColumns een InheritedAutoSizeMode eigenschapswaarde van ColumnHeader en de ColumnHeadersVisible eigenschapswaarde is false.

– of –

Ten minste één van de kolommen bevat dataGridViewColumns een InheritedAutoSizeMode eigenschapswaarde van Fill en een Frozen eigenschapswaarde van true.

– of –

De kolommen in dataGridViewColumns het besturingselement hebben FillWeight eigenschapswaarden waardoor de gecombineerde FillWeight waarden van alle kolommen in het besturingselement groter zijn dan 65535.

– of –

Ten minste twee van de waarden in dataGridViewColumns zijn verwijzingen naar hetzelfde DataGridViewColumn.

– of –

Ten minste één van de kolommen bevat dataGridViewColumnsDisplayIndex en Frozen eigenschapswaarden waarmee deze wordt weergegeven tussen een reeks aangrenzende kolommen met de tegenovergestelde Frozen eigenschapswaarde.

Voorbeelden

Het volgende codevoorbeeld illustreert het gebruik van deze methode. Dit voorbeeld maakt deel uit van een groter voorbeeld dat beschikbaar is in Hoe to: Stel de groottemodi van het Windows Forms DataGridView-besturingselement in.

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."})

Van toepassing op

Zie ook