DataGridViewColumnCollection.AddRange(DataGridViewColumn[]) Método

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll

Adiciona uma variedade 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[]

Um conjunto de DataGridViewColumn objetos para adicionar.

Exceções

ArgumentNullException

dataGridViewColumns é null.

InvalidOperationException

O controlo associado DataGridView está a realizar uma das seguintes ações que impede temporariamente a adição de novas colunas:

  • Selecionar todas as células no controlo.

  • A limpar a seleção.

  • Atualizar os valores das propriedades das colunas DisplayIndex .

-ou-

Este método é chamado a partir de um handler para um dos seguintes DataGridView eventos:

-ou-

Pelo menos um dos valores em dataGridViewColumns é null.

-ou-

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

-ou-

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

-ou-

Pelo menos uma das colunas em dataGridViewColumns tem um SortMode valor de propriedade de Automatic e o SelectionMode valor de propriedade é FullColumnSelect ou ColumnHeaderSelect. Use o controlo ISupportInitialize.BeginInit() e ISupportInitialize.EndInit() os métodos para definir temporariamente valores de propriedades conflitantes.

-ou-

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

-ou-

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

-ou-

As colunas em dataGridViewColumns têm FillWeight valores de propriedades que fariam com que os valores combinados FillWeight de todas as colunas no controlo ultrapassassem 65535.

-ou-

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

-ou-

Pelo menos uma das colunas em dataGridViewColumns tem DisplayIndex valores de propriedade e Frozen que o mostrariam entre um conjunto de colunas adjacentes com o valor de propriedade oposto Frozen .

Exemplos

O seguinte exemplo de código ilustra a utilização deste método. Este exemplo faz parte de um exemplo mais amplo disponível em Como: Definir os Modos de Dimensionamento do Windows Forms Controlo DataGridView.

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

Ver também