DataGridViewColumnCollection.IList.Insert(Int32, Object) 메서드

정의

컬렉션 내의 지정된 인덱스에 요소를 삽입합니다.Inserts an element into the collection at the specified index.

 virtual void System.Collections.IList.Insert(int index, System::Object ^ value) = System::Collections::IList::Insert;
void IList.Insert (int index, object value);
Sub Insert (index As Integer, value As Object) Implements IList.Insert

매개 변수

index
Int32

value을 삽입해야 하는 인덱스(0부터 시작)입니다.The zero-based index at which value should be inserted.

value
Object

삽입할 Object입니다.The Object to insert. 값은 null이 될 수 있습니다.The value can be null.

구현

예외

valueDataGridViewColumn가 아닌 경우value is not a DataGridViewColumn.

valuenull입니다.value is null.

연결된 DataGridView 컨트롤에서 임시로 새 열을 추가하지 못하게 하는 다음 작업 중 하나를 수행하고 있는 경우The associated DataGridView control is performing one of the following actions that temporarily prevents new columns from being added: - 컨트롤의 셀을 모두 선택합니다.- Selecting all cells in the control.

- 선택을 취소합니다.- Clearing the selection.

- 열의 DisplayIndex 속성 값을 업데이트합니다.- Updating column DisplayIndex property values.

또는-or- 이 메서드는 다음 DataGridView 이벤트 중 하나의 처리기에서 호출됩니다.This method is being called from a handler for one of the following DataGridView events:

또는-or- value에서 나타내는 열이 이미 DataGridView 컨트롤에 속해 있는 경우The column indicated by value already belongs to a DataGridView control.

또는-or- value에서 나타내는 열의 SortMode 속성 값이 Automatic이고 SelectionMode 속성 값이 FullColumnSelect 또는 ColumnHeaderSelect인 경우.The SortMode property value of the column indicated by value is Automatic and the SelectionMode property value is FullColumnSelect or ColumnHeaderSelect. 컨트롤의 ISupportInitialize.BeginInit()ISupportInitialize.EndInit() 메서드를 사용하여 충돌하는 속성 값을 임시로 설정합니다.Use the control ISupportInitialize.BeginInit() and ISupportInitialize.EndInit() methods to temporarily set conflicting property values.

또는-or- value에서 나타내는 열의 InheritedAutoSizeMode 속성 값이 ColumnHeader이고 ColumnHeadersVisible 속성 값이 false인 경우The InheritedAutoSizeMode property value of the column indicated by value is ColumnHeader and the ColumnHeadersVisible property value is false.

또는-or- value에서 나타내는 열의 InheritedAutoSizeMode 속성 값이 Fill이고 Frozen 속성 값이 true인 경우The column indicated by value has an InheritedAutoSizeMode property value of Fill and a Frozen property value of true.

또는-or- 컨트롤에 있는 모든 열의 FillWeight 값을 결합할 때 65535가 초과되는 값으로 valueFillWeight 속성이 설정된 경우The column indicated by value has a FillWeight property value that would cause the combined FillWeight values of all columns in the control to exceed 65535.

또는-or- value에서 나타내는 열에, 인접한 열 집합과 DisplayIndex 속성 값이 반대인 열을 표시하는 FrozenFrozen 속성 값이 있는 경우The column indicated by value has DisplayIndex and Frozen property values that would display it among a set of adjacent columns with the opposite Frozen property value.

또는-or- DataGridView 컨트롤에 하나 이상의 행이 있고 value에서 나타내는 열의 CellType 속성 값이 null인 경우The DataGridView control contains at least one row and the column indicated by value has a CellType property value of null.

설명

이 멤버는 명시적 인터페이스 멤버 구현이며,This member is an explicit interface member implementation. DataGridViewColumnCollection 인스턴스가 IList 인터페이스로 캐스팅된 경우에만 사용할 수 있습니다.It can be used only when the DataGridViewColumnCollection instance is cast to an IList interface.

적용 대상

추가 정보