DataGridViewColumnCollection.Add Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Adiciona a coluna fornecida à coleção.
Sobrecargas
| Nome | Description |
|---|---|
| Add(DataGridViewColumn) |
Adiciona a coluna fornecida à coleção. |
| Add(String, String) |
Adiciona um DataGridViewTextBoxColumn texto com o nome da coluna e o cabeçalho de coluna fornecidos à coleção. |
Add(DataGridViewColumn)
Adiciona a coluna fornecida à 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 -> intPublic Overridable Function Add (dataGridViewColumn As DataGridViewColumn) As IntegerParâmetros
- dataGridViewColumn
- DataGridViewColumn
O DataGridViewColumn para adicionar.
Retornos
O índice da coluna.
Exceções
dataGridViewColumn é null.
O controle associado DataGridView está executando uma das seguintes ações que impede temporariamente que novas colunas sejam adicionadas:
Selecionando todas as células no controle.
Desmarcando a seleção.
Atualizando valores de propriedade da coluna DisplayIndex .
- ou -
Esse método está sendo chamado de um manipulador para um dos seguintes DataGridView eventos:
- ou -
dataGridViewColumn já pertence a um DataGridView controle.
- ou -
O dataGridViewColumnSortMode valor da propriedade é Automatic e o valor da SelectionMode propriedade é FullColumnSelect ou ColumnHeaderSelect. Use o controle ISupportInitialize.BeginInit() e ISupportInitialize.EndInit() os métodos para definir temporariamente valores de propriedade conflitantes.
- ou -
O dataGridViewColumnInheritedAutoSizeMode valor da propriedade é ColumnHeader e o valor da ColumnHeadersVisible propriedade é false.
- ou -
dataGridViewColumn tem um InheritedAutoSizeMode valor de propriedade e Fill um Frozen valor de propriedade de true.
- ou -
dataGridViewColumn tem um FillWeight valor de propriedade que faria com que os valores combinados FillWeight de todas as colunas no controle excedessem 65535.
- ou -
dataGridViewColumn tem DisplayIndex e Frozen valores de propriedade que o exibiriam entre um conjunto de colunas adjacentes com o valor da propriedade oposta Frozen .
- ou -
O DataGridView controle contém pelo menos uma linha e dataGridViewColumn tem um CellType valor de propriedade 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
Aplica-se a
Add(String, String)
Adiciona um DataGridViewTextBoxColumn texto com o nome da coluna e o 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);public virtual int Add(string? columnName, string? headerText);abstract member Add : string * string -> int
override this.Add : string * string -> intPublic Overridable Function Add (columnName As String, headerText As String) As IntegerParâmetros
- columnName
- String
O nome pelo qual a coluna será referenciada.
- headerText
- String
O texto do cabeçalho da coluna.
Retornos
O índice da coluna.
Exceções
O controle associado DataGridView está executando uma das seguintes ações que impede temporariamente que novas colunas sejam adicionadas:
Selecionando todas as células no controle.
Desmarcando a seleção.
Atualizando valores de propriedade da coluna DisplayIndex .
- ou -
Esse método está sendo chamado de um manipulador para um dos seguintes DataGridView eventos:
- ou -
O SelectionMode valor da propriedade é FullColumnSelect ou ColumnHeaderSelect, que entra em conflito com o valor da propriedade de coluna SortMode padrão de Automatic.
- ou -
O valor da propriedade de coluna FillWeight padrão de 100 faria com que os valores combinados FillWeight de todas as colunas no controle excedessem 65535.
Comentários
Os columnName parâmetros e os parâmetros headerText estão relacionados com as propriedades e Name as HeaderText propriedades, respectivamente.
