DataGridViewColumnCollection.Add Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Adiciona a coluna dada à coleção.
Sobrecargas
| Name | Description |
|---|---|
| Add(DataGridViewColumn) |
Adiciona a coluna dada à coleção. |
| Add(String, String) |
Adiciona um DataGridViewTextBoxColumn com o nome da coluna indicado e o texto do cabeçalho da coluna à coleção. |
Add(DataGridViewColumn)
Adiciona a coluna dada à 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 a acrescentar.
Devoluções
O índice da coluna.
Exceções
dataGridViewColumn é null.
O controlo associado DataGridView está a realizar uma das seguintes ações que impede temporariamente a adição de novas colunas:
Selecionar todas as células no controlo.
A limpar a seleção.
Atualizar os valores das propriedades das colunas DisplayIndex .
-ou-
Este método é chamado a partir de um handler para um dos seguintes DataGridView eventos:
-ou-
dataGridViewColumn Já pertence a um DataGridView controlo.
-ou-
O dataGridViewColumnSortMode valor da propriedade é Automatic e o SelectionMode valor da propriedade é FullColumnSelect ou ColumnHeaderSelect. Use o controlo ISupportInitialize.BeginInit() e ISupportInitialize.EndInit() os métodos para definir temporariamente valores de propriedades conflitantes.
-ou-
O dataGridViewColumnInheritedAutoSizeMode valor da propriedade é ColumnHeader e o ColumnHeadersVisible valor da propriedade é false.
-ou-
dataGridViewColumn tem um InheritedAutoSizeMode valor de propriedade de Fill e 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 controlo excedessem 65535.
-ou-
dataGridViewColumn tem DisplayIndex e Frozen valores de propriedade que o exibiriam entre um conjunto de colunas adjacentes com o valor de propriedade oposto Frozen .
-ou-
O DataGridView controlo contém pelo menos uma linha e dataGridViewColumn tem um CellType valor de propriedade de null.
Exemplos
O seguinte exemplo de código ilustra a utilização deste 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
Ver também
Aplica-se a
Add(String, String)
Adiciona um DataGridViewTextBoxColumn com o nome da coluna indicado e o texto do cabeçalho da coluna à 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á referida.
- headerText
- String
O texto do cabeçalho da coluna.
Devoluções
O índice da coluna.
Exceções
O controlo associado DataGridView está a realizar uma das seguintes ações que impede temporariamente a adição de novas colunas:
Selecionar todas as células no controlo.
A limpar a seleção.
Atualizar os valores das propriedades das colunas DisplayIndex .
-ou-
Este método é chamado a partir de um handler para um dos seguintes DataGridView eventos:
-ou-
O SelectionMode valor da propriedade é FullColumnSelect ou ColumnHeaderSelect, o que entra em conflito com o valor padrão da propriedade da coluna SortMode de Automatic.
-ou-
O valor padrão da propriedade da coluna FillWeight de 100 faria com que os valores combinados FillWeight de todas as colunas no controlo ultrapassassem 65535.
Observações
Os columnName parâmetros e headerText estão relacionados com as Name propriedades e HeaderText , respetivamente.
