DataGridViewColumnCollection.Add Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Agrega la columna especificada a la colección.
Sobrecargas
| Nombre | Description |
|---|---|
| Add(DataGridViewColumn) |
Agrega la columna especificada a la colección. |
| Add(String, String) |
Agrega un DataGridViewTextBoxColumn objeto con el nombre de columna y el texto del encabezado de columna especificados a la colección. |
Add(DataGridViewColumn)
Agrega la columna especificada a la colección.
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
que DataGridViewColumn se va a agregar.
Devoluciones
Índice de la columna.
Excepciones
dataGridViewColumn es null.
El control asociado DataGridView está realizando una de las siguientes acciones que impide temporalmente que se agreguen nuevas columnas:
Selección de todas las celdas del control.
Borrar la selección.
Actualización de los valores de propiedad de columna DisplayIndex .
O bien
Se llama a este método desde un controlador para uno de los eventos siguientes DataGridView :
O bien
dataGridViewColumn ya pertenece a un DataGridView control .
O bien
El dataGridViewColumnSortMode valor de la propiedad es Automatic y el valor de propiedad SelectionMode es FullColumnSelect o ColumnHeaderSelect. Use el control ISupportInitialize.BeginInit() y ISupportInitialize.EndInit() los métodos para establecer temporalmente valores de propiedad en conflicto.
O bien
El dataGridViewColumnInheritedAutoSizeMode valor de la propiedad es ColumnHeader y el valor de propiedad ColumnHeadersVisible es false.
O bien
dataGridViewColumn tiene un InheritedAutoSizeMode valor de propiedad de Fill y un Frozen valor de propiedad de true.
O bien
dataGridViewColumn tiene un FillWeight valor de propiedad que haría que los valores combinados FillWeight de todas las columnas del control superaran los 65535.
O bien
dataGridViewColumn tiene DisplayIndex valores de propiedad y Frozen que lo mostrarían entre un conjunto de columnas adyacentes con el valor de propiedad opuesto Frozen .
O bien
El DataGridView control contiene al menos una fila y dataGridViewColumn tiene un CellType valor de propiedad de null.
Ejemplos
En el ejemplo de código siguiente se muestra el uso de este 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
Consulte también
Se aplica a
Add(String, String)
Agrega un DataGridViewTextBoxColumn objeto con el nombre de columna y el texto del encabezado de columna especificados a la colección.
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
Nombre por el que se hará referencia a la columna.
- headerText
- String
Texto del encabezado de la columna.
Devoluciones
Índice de la columna.
Excepciones
El control asociado DataGridView está realizando una de las siguientes acciones que impide temporalmente que se agreguen nuevas columnas:
Selección de todas las celdas del control.
Borrar la selección.
Actualización de los valores de propiedad de columna DisplayIndex .
O bien
Se llama a este método desde un controlador para uno de los eventos siguientes DataGridView :
O bien
El SelectionMode valor de propiedad es FullColumnSelect o ColumnHeaderSelect, que entra en conflicto con el valor de propiedad de columna SortMode predeterminado de Automatic.
O bien
El valor de propiedad de columna FillWeight predeterminado de 100 provocaría que los valores combinados FillWeight de todas las columnas del control superen los 65535.
Comentarios
Los columnName parámetros y headerText están relacionados con las Name propiedades y HeaderText , respectivamente.
