DataGridViewColumnCollection.IList.Add(Object) Methode

  • Referenz

Definition

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

Fügt ein Objekt am Ende der Auflistung hinzu.

 virtual int System.Collections.IList.Add(System::Object ^ value) = System::Collections::IList::Add;
int IList.Add (object value);
abstract member System.Collections.IList.Add : obj -> int
override this.System.Collections.IList.Add : obj -> int
Function Add (value As Object) As Integer Implements IList.Add

Parameter

value
Object

Der Object, der am Ende der Auflistung hinzugefügt werden soll. Der Wert kann null sein.

Gibt zurück

Int32

Der Index, an dem der value hinzugefügt wurde.

Implementiert

Add(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.

– 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 - 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

Siehe auch