DataGridViewColumnCollection.Add Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Adiciona a coluna especificada na coleção.

Sobrecargas

Add(DataGridViewColumn)	Adiciona a coluna especificada na coleção.
Add(String, String)	Adiciona um DataGridViewTextBoxColumn com o nome de coluna e o texto do cabeçalho de coluna fornecidos à coleção.

Add(DataGridViewColumn)

Adiciona a coluna especificada na coleção.

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

Parâmetros

dataGridViewColumn

DataGridViewColumn

O DataGridViewColumn a ser adicionado.

Retornos

Int32

O índice da coluna.

Exceções

ArgumentNullException

dataGridViewColumn é null.

InvalidOperationException

O controle DataGridView associado está executando uma das seguintes ações, que impedem temporariamente que novas colunas sejam adicionadas:

• Selecionando todas as células no controle.

• Limpando a seleção.

• Atualizando os valores de propriedade DisplayIndex da coluna.

- ou - Esse método está sendo chamado de um manipulador para um dos seguintes eventos DataGridView:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- ou - dataGridViewColumn já pertence a um controle DataGridView.

- ou - O valor da propriedade dataGridViewColumnSortMode é Automatic e o valor da propriedade SelectionMode é FullColumnSelect ou ColumnHeaderSelect. Use os métodos ISupportInitialize.BeginInit() e ISupportInitialize.EndInit() do controle para definir valores de propriedade conflitantes temporariamente.

- ou - O valor da propriedade dataGridViewColumnInheritedAutoSizeMode é ColumnHeader e o valor da propriedade ColumnHeadersVisible é false.

- ou - dataGridViewColumn tem um valor da propriedade InheritedAutoSizeMode de Fill e um valor da propriedade Frozen de true.

- ou - dataGridViewColumn tem um valor da propriedade FillWeight que fará com que os valores FillWeight combinados de todas as colunas no controle excedam 65535.

- ou - dataGridViewColumn tem valores da propriedade DisplayIndex e Frozen que serão exibidos entre um conjunto de colunas adjacentes com o valor da propriedade Frozen oposto.

- ou - O controle DataGridView contém pelo menos uma linha e dataGridViewColumn tem um valor da propriedade CellType de null.

Exemplos

O exemplo de código a seguir ilustra o uso desse método.

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

Confira também

• DataGridView
• DataGridViewColumn

Add(String, String)

Adiciona um DataGridViewTextBoxColumn com o nome de coluna e o texto do cabeçalho de coluna fornecidos à coleção.

public:
 virtual int Add(System::String ^ columnName, System::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

Parâmetros

columnName

String

O nome pelo qual a coluna será referida.

headerText

String

O texto do cabeçalho da coluna.

Retornos

Int32

O índice da coluna.

Exceções

InvalidOperationException

O controle DataGridView associado está executando uma das seguintes ações, que impedem temporariamente que novas colunas sejam adicionadas:

• Selecionando todas as células no controle.

• Limpando a seleção.

• Atualizando os valores de propriedade DisplayIndex da coluna.

- ou - Esse método está sendo chamado de um manipulador para um dos seguintes eventos DataGridView:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

- ou - O valor da propriedade SelectionMode é FullColumnSelect ou ColumnHeaderSelect, o que está em conflito com o valor da propriedade Automatic da coluna padrão SortMode.

- ou - O valor da propriedade FillWeight da coluna padrão de 100 fará com que os valores FillWeight combinados de todas as colunas no controle excedam 65535.

Comentários

Os parâmetros e headerText os columnName parâmetros estão relacionados às propriedades e HeaderText às Name propriedades, respectivamente.

Confira também

• DataGridView
• DataGridViewColumn