DataGridViewColumnCollection.Insert(Int32, DataGridViewColumn) 메서드

정의

네임스페이스:
System.Windows.Forms
어셈블리:
System.Windows.Forms.dll
Source:
DataGridViewColumnCollection.cs
Source:
DataGridViewColumnCollection.cs
Source:
DataGridViewColumnCollection.cs
Source:
DataGridViewColumnCollection.cs
Source:
DataGridViewColumnCollection.cs

컬렉션의 지정된 인덱스에 열을 삽입합니다.

public:
 virtual void Insert(int columnIndex, System::Windows::Forms::DataGridViewColumn ^ dataGridViewColumn);
public virtual void Insert(int columnIndex, System.Windows.Forms.DataGridViewColumn dataGridViewColumn);
abstract member Insert : int * System.Windows.Forms.DataGridViewColumn -> unit
override this.Insert : int * System.Windows.Forms.DataGridViewColumn -> unit
Public Overridable Sub Insert (columnIndex As Integer, dataGridViewColumn As DataGridViewColumn)

매개 변수

columnIndex
Int32

지정된 열을 삽입할 인덱스(0부터 시작하는 인덱스)입니다.

dataGridViewColumn
DataGridViewColumn

삽입할 항목입니다 DataGridViewColumn .

예외

ArgumentNullException

dataGridViewColumn은 null입니다.

InvalidOperationException

연결된 DataGridView 컨트롤은 새 열이 추가되지 않도록 일시적으로 방지하는 다음 작업 중 하나를 수행합니다.

  • 컨트롤의 모든 셀 선택

  • 선택 영역 지우기

  • 열 DisplayIndex 속성 값을 업데이트합니다.

-또는-

이 메서드는 다음 DataGridView 이벤트 중 하나에 대한 처리기에서 호출됩니다.

-또는-

dataGridViewColumn 이미 컨트롤에 DataGridView 속합니다.

-또는-

dataGridViewColumn SortMode 속성 값이 Automatic 고 속성 값이 SelectionModeFullColumnSelect or ColumnHeaderSelect. 컨트롤 ISupportInitialize.BeginInit() 및 ISupportInitialize.EndInit() 메서드를 사용하여 충돌하는 속성 값을 일시적으로 설정합니다.

-또는-

속성 값이 dataGridViewColumn 고 속성 값은 InheritedAutoSizeMode .입니다ColumnHeader.ColumnHeadersVisiblefalse

-또는-

dataGridViewColumn의 InheritedAutoSizeMode 속성 값 Fill 과 속성 값Frozen이 true 있습니다.

-또는-

dataGridViewColumn DisplayIndex 에는 Frozen 반대 Frozen 속성 값이 있는 인접 열 집합에 표시되는 속성 값이 있습니다.

-또는-

컨트롤에 DataGridView 하나 이상의 행이 포함되며 dataGridViewColumn 속성 값CellType은 null .입니다.

예제

다음 코드 예제에서는이 메서드의 사용을 보여 줍니다. 자세한 내용은 방법: Data-Bound Windows Forms DataGridView 컨트롤에 언바운드 열 추가 참조하세요.

private void CreateUnboundButtonColumn()
{
    // Initialize the button column.
    DataGridViewButtonColumn buttonColumn =
        new DataGridViewButtonColumn();
    buttonColumn.Name = "Details";
    buttonColumn.HeaderText = "Details";
    buttonColumn.Text = "View Details";

    // Use the Text property for the button text for all cells rather
    // than using each cell's value as the text for its own button.
    buttonColumn.UseColumnTextForButtonValue = true;

    // Add the button column to the control.
    dataGridView1.Columns.Insert(0, buttonColumn);
}

Private Sub CreateUnboundButtonColumn()

    ' Initialize the button column.
    Dim buttonColumn As New DataGridViewButtonColumn

    With buttonColumn
        .HeaderText = "Details"
        .Name = "Details"
        .Text = "View Details"

        ' Use the Text property for the button text for all cells rather
        ' than using each cell's value as the text for its own button.
        .UseColumnTextForButtonValue = True
    End With

    ' Add the button column to the control.
    dataGridView1.Columns.Insert(0, buttonColumn)

End Sub

적용 대상

추가 정보