Udostępnij za pośrednictwem

DataGridViewColumnCollection.IList.Add(Object) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Dodaje obiekt na końcu kolekcji.

 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

Parametry

value
Object

Element Object do dodania na końcu kolekcji. Wartość może mieć wartość null.

Zwraca

Int32

Indeks, w którym value został dodany.

Implementuje

Add(Object)

Wyjątki

InvalidCastException

valuenie jest .DataGridViewColumn

ArgumentNullException

value to null.

InvalidOperationException

Skojarzona DataGridView kontrolka wykonuje jedną z następujących akcji, która tymczasowo uniemożliwia dodawanie nowych kolumn:

  • Zaznaczanie wszystkich komórek w kontrolce.

— Wyczyszczenie zaznaczenia.

  • Aktualizowanie wartości właściwości kolumny DisplayIndex .

-lub- Ta metoda jest wywoływana z programu obsługi dla jednego z następujących DataGridView zdarzeń:

-lub- Kolumna wskazywana przez value już należy do kontrolki DataGridView .

-lub- Wartość SortMode właściwości kolumny wskazanej przez value wartość to Automatic , a SelectionMode wartość właściwości to FullColumnSelect lub ColumnHeaderSelect. Użyj kontrolki ISupportInitialize.BeginInit() i ISupportInitialize.EndInit() metod, aby tymczasowo ustawić wartości właściwości powodujących konflikt.

-lub- Wartość InheritedAutoSizeMode właściwości kolumny wskazanej przez value element to ColumnHeader , a ColumnHeadersVisible wartość właściwości to false.

-lub- Kolumna wskazywana przez value element ma InheritedAutoSizeMode wartość Fill właściwości i Frozen wartość właściwości .true

-lub- Kolumna wskazywana przez value element FillWeight ma wartość właściwości, która spowodowałaby, że łączne FillWeight wartości wszystkich kolumn w kontrolce przekroczyły 65535.

-lub- Kolumna wskazywana przez element value zawiera DisplayIndex wartości właściwości i Frozen , które wyświetlałyby ją wśród zestawu sąsiednich kolumn z przeciwną Frozen wartością właściwości.

-lub- Kontrolka DataGridView zawiera co najmniej jeden wiersz, a kolumna wskazana przez value element ma CellType wartość nullwłaściwości .

Uwagi

Ten element jest jawną implementacją członków. Można go używać tylko wtedy, gdy DataGridViewColumnCollection wystąpienie jest rzutowe do interfejsu IList .

Dotyczy

Zobacz też