DataGridViewColumnCollection.IList.Insert(Int32, Object) Methode

  • Referenz

Definition

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

Fügt ein Element am angegebenen Index in die Auflistung ein.

 virtual void System.Collections.IList.Insert(int index, System::Object ^ value) = System::Collections::IList::Insert;
void IList.Insert (int index, object value);
void IList.Insert (int index, object? value);
abstract member System.Collections.IList.Insert : int * obj -> unit
override this.System.Collections.IList.Insert : int * obj -> unit
Sub Insert (index As Integer, value As Object) Implements IList.Insert

Parameter

index
Int32

Der nullbasierte Index, an dem value eingefügt werden soll.

value
Object

Der einzufügende Object. Der Wert kann null sein.

Implementiert

Insert(Int32, Object)

Ausnahmen

InvalidCastException

value ist keine DataGridViewColumn.

ArgumentNullException

value 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.

  • Die Auswahl wird gelöscht.

  • Aktualisieren von Spalteneigenschaftswerten DisplayIndex .

- oder -

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

- oder -

Die durch value angegebene Spalte gehört bereits zu einem DataGridView-Steuerelement.

- oder -

Der SortMode-Eigenschaftswert der durch value angegebenen Spalte ist 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 -

Der InheritedAutoSizeMode-Eigenschaftswert der durch value angegebenen Spalte ist ColumnHeader, und der ColumnHeadersVisible-Eigenschaftswert ist false.

- oder -

Die durch value angegebene Spalte besitzt den InheritedAutoSizeMode-Eigenschaftswert Fill und den Frozen-Eigenschaftswert true.

- oder -

Die durch value angegebene Spalte besitzt einen FillWeight-Eigenschaftswert, der dazu führt, dass die FillWeight-Werte aller Spalten im Steuerelement zusammen 65535 übersteigen.

- oder -

Die durch value angegebene Spalte besitzt einen DisplayIndex-Eigenschaftswert und einen Frozen-Eigenschaftswert, durch die sie in einer Gruppe nebeneinander liegender Spalten mit entgegengesetztem Frozen-Eigenschaftswert angezeigt wird.

- oder -

Das DataGridView-Steuerelement enthält mindestens eine Zeile, und die durch value angegebene Spalte besitzt den CellType-Eigenschaftswert null.

Hinweise

Bei diesem Member handelt es sich um eine explizite Schnittstellenmemberimplementierung. Er kann nur verwendet werden, wenn die DataGridViewColumnCollection-Instanz in eine IList-Schnittstelle umgewandelt wird.

Gilt für:

Weitere Informationen