DataGridViewColumnCollection.AddRange(DataGridViewColumn[]) Método

  • Referencia

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 objetos DataGridViewColumn que se va a agregar.

Excepciones

ArgumentNullException

dataGridViewColumns es null.

InvalidOperationException

El control DataGridView asociado está realizando una de las acciones siguientes que impide temporalmente que se agreguen nuevas columnas:

  • Seleccionar todas las celdas del control.

  • Borrar la selección.

  • Actualizar los valores de propiedades DisplayIndex de la columna.

o bien Se llama a este método desde un controlador para uno de los siguientes eventos DataGridView:

o bien Por lo menos uno de los valores de dataGridViewColumns es null.

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

o bien Al menos una de las columnas de dataGridViewColumns tiene un valor null para la propiedad CellType y el control DataGridView contiene una fila por lo menos.

o bien Al menos una de las columnas de dataGridViewColumns tiene un valor de la propiedad SortMode de Automatic y el valor de la propiedad SelectionMode es FullColumnSelect o ColumnHeaderSelect. Utilice los métodos ISupportInitialize.BeginInit() y ISupportInitialize.EndInit() del control para establecer temporalmente los valores de propiedades que entren en conflicto.

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

o bien Al menos una de las columnas de dataGridViewColumns tiene un valor de la propiedad InheritedAutoSizeMode de Fill y el valor de la propiedad Frozen es true.

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

o bien Al menos dos de los valores de dataGridViewColumns son referencias al mismo DataGridViewColumn.

o bien Al menos una de las columnas de dataGridViewColumns tiene unos valores de las propiedades DisplayIndex y Frozen que lo mostrarían entre un conjunto de columnas adyacentes con el valor contrario de la propiedad 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