DataGridViewColumnCollection.AddRange(DataGridViewColumn[]) Método

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 DataGridViewColumn objetos a serem adicionados.

Exceções

ArgumentNullException

dataGridViewColumns é null.

InvalidOperationException

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

  • Selecionando todas as células no controle.

  • Desmarcando a seleção.

  • Atualizando valores de propriedade da coluna DisplayIndex .

-ou-

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

-ou-

Pelo menos um dos valores em dataGridViewColumns é null.

-ou-

Pelo menos uma das colunas em dataGridViewColumns que já pertence a um DataGridView controle.

-ou-

Pelo menos uma das colunas tem dataGridViewColumns um valor de null propriedade e o DataGridView controle contém pelo CellType menos uma linha.

-ou-

Pelo menos uma das colunas em tem um valor de propriedade e o valor da SelectionModeAutomatic propriedade é FullColumnSelect ou ColumnHeaderSelect.SortModedataGridViewColumns Use o controle ISupportInitialize.BeginInit() e ISupportInitialize.EndInit() os métodos para definir temporariamente valores de propriedade conflitantes.

-ou-

Pelo menos uma das colunas em tem um InheritedAutoSizeMode valor de propriedade e o valor da ColumnHeaderColumnHeadersVisible propriedade é false.dataGridViewColumns

-ou-

Pelo menos uma das colunas em tem um InheritedAutoSizeMode valor de Fill propriedade e um Frozen valor de propriedade de true.dataGridViewColumns

-ou-

As colunas têm dataGridViewColumnsFillWeight valores de propriedade que fariam com que os valores combinados FillWeight de todas as colunas no controle excedessem 65535.

-ou-

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

-ou-

Pelo menos uma das colunas em dataGridViewColumns tem DisplayIndex e Frozen valores de propriedade que a exibiriam entre um conjunto de colunas adjacentes com o valor da propriedade oposta Frozen .

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