DataGridViewColumnCollection.Add 메서드

정의

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

컬렉션에 지정된 열을 추가합니다.

오버로드

Name Description
Add(DataGridViewColumn)

컬렉션에 지정된 열을 추가합니다.
Add(String, String)

DataGridViewTextBoxColumn 지정된 열 이름 및 열 머리글 텍스트를 사용하여 컬렉션에 추가합니다.

Add(DataGridViewColumn)

Source:
DataGridViewColumnCollection.cs
Source:
DataGridViewColumnCollection.cs
Source:
DataGridViewColumnCollection.cs
Source:
DataGridViewColumnCollection.cs
Source:
DataGridViewColumnCollection.cs

컬렉션에 지정된 열을 추가합니다.

public:
 virtual int Add(System::Windows::Forms::DataGridViewColumn ^ dataGridViewColumn);
public virtual int Add(System.Windows.Forms.DataGridViewColumn dataGridViewColumn);
abstract member Add : System.Windows.Forms.DataGridViewColumn -> int
override this.Add : System.Windows.Forms.DataGridViewColumn -> int
Public Overridable Function Add (dataGridViewColumn As DataGridViewColumn) As Integer

매개 변수

dataGridViewColumn
DataGridViewColumn

추가할 개체입니다 DataGridViewColumn .

반품

Int32

열의 인덱스입니다.

예외

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 에는 FillWeight 컨트롤에 있는 모든 열의 결합된 FillWeight 값이 65535를 초과하는 속성 값이 있습니다.

-또는-

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

-또는-

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

예제

다음 코드 예제에서는이 메서드의 사용을 보여 줍니다.

private DataGridView dataGridView1 = new DataGridView();

private void AddColorColumn()
{
    DataGridViewComboBoxColumn comboBoxColumn =
        new DataGridViewComboBoxColumn();
    comboBoxColumn.Items.AddRange(
        Color.Red, Color.Yellow, Color.Green, Color.Blue);
    comboBoxColumn.ValueType = typeof(Color);
    dataGridView1.Columns.Add(comboBoxColumn);
    dataGridView1.EditingControlShowing +=
        new DataGridViewEditingControlShowingEventHandler(
        dataGridView1_EditingControlShowing);
}

private void dataGridView1_EditingControlShowing(object sender,
    DataGridViewEditingControlShowingEventArgs e)
{
    ComboBox combo = e.Control as ComboBox;
    if (combo != null)
    {
        // Remove an existing event-handler, if present, to avoid 
        // adding multiple handlers when the editing control is reused.
        combo.SelectedIndexChanged -=
            new EventHandler(ComboBox_SelectedIndexChanged);

        // Add the event handler. 
        combo.SelectedIndexChanged +=
            new EventHandler(ComboBox_SelectedIndexChanged);
    }
}

private void ComboBox_SelectedIndexChanged(object sender, EventArgs e)
{
    ((ComboBox)sender).BackColor = (Color)((ComboBox)sender).SelectedItem;
}

Private WithEvents dataGridView1 As New DataGridView()

Private Sub AddColorColumn()

    Dim comboBoxColumn As New DataGridViewComboBoxColumn()
    comboBoxColumn.Items.AddRange( _
        Color.Red, Color.Yellow, Color.Green, Color.Blue)
    comboBoxColumn.ValueType = GetType(Color)
    dataGridView1.Columns.Add(comboBoxColumn)

End Sub

Private Sub dataGridView1_EditingControlShowing(ByVal sender As Object, _
    ByVal e As DataGridViewEditingControlShowingEventArgs) _
    Handles dataGridView1.EditingControlShowing

    Dim combo As ComboBox = CType(e.Control, ComboBox)
    If (combo IsNot Nothing) Then

        ' Remove an existing event-handler, if present, to avoid 
        ' adding multiple handlers when the editing control is reused.
        RemoveHandler combo.SelectedIndexChanged, _
            New EventHandler(AddressOf ComboBox_SelectedIndexChanged)

        ' Add the event handler. 
        AddHandler combo.SelectedIndexChanged, _
            New EventHandler(AddressOf ComboBox_SelectedIndexChanged)

    End If

End Sub

Private Sub ComboBox_SelectedIndexChanged( _
    ByVal sender As Object, ByVal e As EventArgs)

    Dim comboBox1 As ComboBox = CType(sender, ComboBox)
    comboBox1.BackColor = _
        CType(CType(sender, ComboBox).SelectedItem, Color)

End Sub

추가 정보

적용 대상

Add(String, String)

Source:
DataGridViewColumnCollection.cs
Source:
DataGridViewColumnCollection.cs
Source:
DataGridViewColumnCollection.cs
Source:
DataGridViewColumnCollection.cs
Source:
DataGridViewColumnCollection.cs

DataGridViewTextBoxColumn 지정된 열 이름 및 열 머리글 텍스트를 사용하여 컬렉션에 추가합니다.

public:
 virtual int Add(System::String ^ columnName, System::String ^ headerText);
public virtual int Add(string columnName, string headerText);
public virtual int Add(string? columnName, string? headerText);
abstract member Add : string * string -> int
override this.Add : string * string -> int
Public Overridable Function Add (columnName As String, headerText As String) As Integer

매개 변수

columnName
String

열을 참조할 이름입니다.

headerText
String

열 머리글의 텍스트입니다.

반품

Int32

열의 인덱스입니다.

예외

InvalidOperationException

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

  • 컨트롤의 모든 셀 선택

  • 선택 영역 지우기

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

-또는-

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

-또는-

SelectionMode 속성 값이 FullColumnSelect 거나 ColumnHeaderSelect기본 열 SortMode 속성 값과 충돌하는 값입니다Automatic.

-또는-

기본 열 FillWeight 속성 값이 100이면 컨트롤에 있는 모든 열의 결합된 FillWeight 값이 65535를 초과하게 됩니다.

설명

columnName 및 headerText 매개 변수는 각각 및 속성과 Name 관련이 HeaderText 있습니다.

추가 정보

적용 대상