Compartilhar via

DataGridViewColumnCollection.AddRange(DataGridViewColumn[]) Método

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Adiciona um intervalo de colunas à coleção.

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[]

Uma matriz de objetos DataGridViewColumn a ser adicionada.

Exceções

ArgumentNullException

dataGridViewColumns é null.

InvalidOperationException

O controle DataGridView associado está executando uma das seguintes ações, que impedem temporariamente que novas colunas sejam adicionadas:

  • Selecionando todas as células no controle.

  • Limpando a seleção.

  • Atualizando os valores de propriedade DisplayIndex da coluna.

- ou - Esse método está sendo chamado de um manipulador para um dos seguintes eventos DataGridView:

- ou - Pelo menos um dos valores do dataGridViewColumns é null.

- ou - Pelo menos uma das colunas do dataGridViewColumns já pertence a um controle DataGridView.

- ou - Pelo menos uma das colunas do dataGridViewColumns tem um valor da propriedade CellType igual a null e o controle DataGridView contém, no mínimo, uma linha.

- ou - Pelo menos uma das colunas do dataGridViewColumns tem um valor da propriedade SortMode igual a Automatic e o valor da propriedade SelectionMode é FullColumnSelect ou ColumnHeaderSelect. Use os métodos ISupportInitialize.BeginInit() e ISupportInitialize.EndInit() do controle para definir valores de propriedade conflitantes temporariamente.

- ou - Pelo menos uma das colunas do dataGridViewColumns tem um valor da propriedade InheritedAutoSizeMode igual a ColumnHeader e o valor da propriedade ColumnHeadersVisible é false.

- ou - Pelo menos uma das colunas do dataGridViewColumns tem um valor da propriedade InheritedAutoSizeMode igual a Fill e um valor da propriedade Frozen igual a true.

- ou - As colunas do dataGridViewColumns têm valores de propriedade FillWeight que farão com que os valores FillWeight combinados de todas as colunas no controle excedam 65.535.

- ou - Pelo menos dois dos valores do dataGridViewColumns são referências ao mesmo DataGridViewColumn.

- ou - Pelo menos uma das colunas do dataGridViewColumns tem valores da propriedade DisplayIndex e Frozen que serão exibidos entre um conjunto de colunas adjacentes com o valor da propriedade Frozen oposto.

Exemplos

O exemplo de código a seguir ilustra o uso desse método. Este exemplo faz parte de um exemplo maior disponível em 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."})

Aplica-se a

Confira também