DataGridViewColumnCollection.AddRange(DataGridViewColumn[]) Metodo

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Origine:
DataGridViewColumnCollection.cs
Origine:
DataGridViewColumnCollection.cs
Origine:
DataGridViewColumnCollection.cs
Origine:
DataGridViewColumnCollection.cs
Origine:
DataGridViewColumnCollection.cs

Aggiunge un intervallo di colonne all'insieme.

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())

Parametri

dataGridViewColumns
DataGridViewColumn[]

Matrice di DataGridViewColumn oggetti da aggiungere.

Eccezioni

ArgumentNullException

dataGridViewColumns è null.

InvalidOperationException

Il controllo associato DataGridView esegue una delle azioni seguenti che impedisce temporaneamente l'aggiunta di nuove colonne:

  • Selezione di tutte le celle nel controllo .

  • Cancellazione della selezione.

  • Aggiornamento dei valori delle proprietà della colonna DisplayIndex .

oppure

Questo metodo viene chiamato da un gestore per uno degli eventi seguenti DataGridView :

oppure

Almeno uno dei valori in dataGridViewColumns è null.

oppure

Almeno una delle colonne in dataGridViewColumns appartiene già a un DataGridView controllo .

oppure

Almeno una delle colonne in dataGridViewColumns ha un CellType valore della null proprietà e il DataGridView controllo contiene almeno una riga.

oppure

Almeno una delle colonne in dataGridViewColumns ha un SortMode valore della Automatic proprietà e il valore della SelectionMode proprietà è FullColumnSelect o ColumnHeaderSelect. Utilizzare il controllo ISupportInitialize.BeginInit() e ISupportInitialize.EndInit() i metodi per impostare temporaneamente i valori delle proprietà in conflitto.

oppure

Almeno una delle colonne in ha un dataGridViewColumns valore della InheritedAutoSizeMode proprietà e il valore della ColumnHeader proprietà è ColumnHeadersVisible.false

oppure

Almeno una delle colonne in dataGridViewColumns ha un InheritedAutoSizeMode valore della Fill proprietà e un Frozen valore della proprietà pari truea .

oppure

Le colonne in dataGridViewColumns hanno FillWeight valori di proprietà che causerebbero il superamento di 65535 dei valori combinati FillWeight di tutte le colonne nel controllo.

oppure

Almeno due dei valori in dataGridViewColumns sono riferimenti allo stesso DataGridViewColumnoggetto .

oppure

Almeno una delle colonne in dataGridViewColumns ha DisplayIndex valori di proprietà e Frozen che lo visualizzano tra un set di colonne adiacenti con il valore della proprietà opposto Frozen .

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo metodo. Questo esempio fa parte di un esempio più ampio disponibile in Procedura: Impostare le modalità di ridimensionamento del controllo DataGridView di Windows Form.

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."})

Si applica a

Vedi anche