DataGridViewColumnCollection.AddRange(DataGridViewColumn[]) Método

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Agrega un intervalo de columnas a la colección.

public:
 virtual void AddRange(... cli::array <System::Windows::Forms::DataGridViewColumn ^> ^ dataGridViewColumns);
public virtual void AddRange(params System.Windows.Forms.DataGridViewColumn[] dataGridViewColumns);
abstract member AddRange : System.Windows.Forms.DataGridViewColumn[] -> unit
override this.AddRange : System.Windows.Forms.DataGridViewColumn[] -> unit
Public Overridable Sub AddRange (ParamArray dataGridViewColumns As DataGridViewColumn())

Parámetros

dataGridViewColumns
DataGridViewColumn[]

Matriz de DataGridViewColumn objetos que se van a agregar.

Excepciones

ArgumentNullException

dataGridViewColumns es null.

InvalidOperationException

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

Al menos uno de los valores de dataGridViewColumns es null.

O bien

Al menos una de las columnas de dataGridViewColumns ya pertenece a un DataGridView control .

O bien

Al menos una de las columnas de dataGridViewColumns tiene un CellType valor de propiedad de null y el DataGridView control contiene al menos una fila.

O bien

Al menos una de las columnas de dataGridViewColumns tiene un SortMode valor de propiedad de y el valor de Automatic 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

Al menos una de las columnas de dataGridViewColumns tiene un InheritedAutoSizeMode valor de propiedad de y el valor de ColumnHeader propiedad ColumnHeadersVisible es false.

O bien

Al menos una de las columnas de dataGridViewColumns tiene un InheritedAutoSizeMode valor de propiedad de Fill y un Frozen valor de propiedad de true.

O bien

Las columnas de dataGridViewColumns tienen FillWeight valores de propiedad que harían que los valores combinados FillWeight de todas las columnas del control superen los 65535.

O bien

Al menos dos de los valores de dataGridViewColumns son referencias a la misma DataGridViewColumn.

O bien

Al menos una de las columnas de dataGridViewColumns tiene DisplayIndex valores de propiedad y Frozen que lo mostrarían entre un conjunto de columnas adyacentes con el valor de propiedad opuesto Frozen .

Ejemplos

En el ejemplo de código siguiente se muestra el uso de este método. Este ejemplo forma parte de un ejemplo más grande disponible en How to: Set the Sizing Modes of the Windows Forms DataGridView Control.

dataGridView1.Columns.AddRange(new DataGridViewTextBoxColumn[] { 
    idColumn, titleColumn, subTitleColumn, 
    summaryColumn, contentColumn });
dataGridView1.Rows.Add(new String[] { "1", 
    "A Short Title", "A Longer SubTitle", 
    "A short description of the main point.", 
    "The full contents of the topic, with detailed examples." });

dataGridView1.Columns.AddRange(New DataGridViewTextBoxColumn() { _
    idColumn, titleColumn, subTitleColumn, _
    summaryColumn, contentColumn})
dataGridView1.Rows.Add(New String() {"1", _
    "A Short Title", "A Longer SubTitle", _
    "A short description of the main point.", _
    "The full contents of the topic, with detailed examples."})

Se aplica a

Consulte también