DataGridViewColumnCollection.AddRange(DataGridViewColumn[]) Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Fügt der Auflistung einen Spaltenbereich hinzu.

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

Parameter

dataGridViewColumns
DataGridViewColumn[]

Ein Array von DataGridViewColumn-Objekten, die hinzugefügt werden sollen.

Ausnahmen

ArgumentNullException

dataGridViewColumns ist null.

InvalidOperationException

Das zugeordnete DataGridView-Steuerelement führt eine der folgenden Aktionen durch, die vorübergehend das Hinzufügen neuer Spalten verhindert: – Auswählen aller Zellen im Steuerelement.

– Aufheben der Auswahl.

– Aktualisieren der Eigenschaftswerte in Spalte DisplayIndex.

- oder - Diese Methode wird von einem Handler für eines der folgenden DataGridView-Ereignisse aufgerufen:

- oder - Mindestens einer der Werte in dataGridViewColumns ist null.

- oder - Mindestens eine der Spalten in dataGridViewColumns gehört bereits zu einem DataGridView-Steuerelement.

- oder - Mindestens eine der Spalten in dataGridViewColumns besitzt den CellType-Eigenschaftswert null, und das DataGridView-Steuerelement enthält mindestens eine Zeile.

- oder - Mindestens eine der Spalten in dataGridViewColumns besitzt den SortMode-Eigenschaftswert Automatic, und der SelectionMode-Eigenschaftswert ist FullColumnSelect oder ColumnHeaderSelect. Verwenden Sie die ISupportInitialize.BeginInit()-Methode und die ISupportInitialize.EndInit()-Methode des Steuerelements, um vorübergehend in Konflikt stehende Eigenschaftswerte festzulegen.

- oder - Mindestens eine der Spalten in dataGridViewColumns besitzt den InheritedAutoSizeMode-Eigenschaftswert ColumnHeader, und der ColumnHeadersVisible-Eigenschaftswert ist false.

- oder - Mindestens eine der Spalten in dataGridViewColumns besitzt den InheritedAutoSizeMode-Eigenschaftswert Fill und den Frozen-Eigenschaftswert true.

- oder - Die Spalten in dataGridViewColumns besitzen FillWeight-Eigenschaftswerte, die dazu führen, dass die FillWeight-Werte aller Spalten im Steuerelement zusammen 65535 übersteigen.

- oder - Mindestens zwei der Werte in dataGridViewColumns sind Verweise auf die gleiche DataGridViewColumn.

- oder - Mindestens eine der Spalten in dataGridViewColumns besitzt einen DisplayIndex-Eigenschaftswert und einen Frozen-Eigenschaftswert, durch die sie in einer Gruppe nebeneinander liegender Spalten mit entgegengesetztem Frozen-Eigenschaftswert angezeigt wird.

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieser Methode veranschaulicht. Dieses Beispiel ist Teil eines größeren Beispiels, das in How to: Set the Sizing Modes of the Windows Forms DataGridView Control.

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

Gilt für

Siehe auch