DataGridViewColumnCollection.AddRange(DataGridViewColumn[]) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Aggiunge all'insieme un intervallo di colonne.

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 oggetti DataGridViewColumn da aggiungere.

Eccezioni

ArgumentNullException

dataGridViewColumns è null.

InvalidOperationException

Il controllo DataGridView associato sta eseguendo una delle azioni riportate di seguito che impedisce temporaneamente di aggiungere nuove colonne:

  • Selezione di tutte le celle del controllo.

  • Annullamento della selezione.

  • Aggiornamento dei valori della proprietà DisplayIndex della colonna.

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

-oppure- Almeno uno dei valori di dataGridViewColumns è null.

-oppure- Almeno una delle colonne di dataGridViewColumns appartiene già a un controllo DataGridView.

-oppure- Almeno una delle colonne di dataGridViewColumns ha null come valore della proprietà CellType e il controllo DataGridView contiene almeno una riga.

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

-oppure- Almeno una delle colonne di dataGridViewColumns ha InheritedAutoSizeMode come valore della proprietà ColumnHeader mentre il valore della proprietà ColumnHeadersVisible è false.

-oppure- Almeno una delle colonne di dataGridViewColumns ha InheritedAutoSizeMode come valore della proprietà Fill mentre il valore della proprietà Frozen è true.

-oppure- Le colonne in dataGridViewColumns hanno i valori della proprietà FillWeight che fanno sì che la somma dei valori di FillWeight di tutte le colonne nel controllo superi 65535.

-oppure- Almeno due dei valori in dataGridViewColumns fanno riferimento allo stesso oggetto DataGridViewColumn.

-oppure- Almeno una delle colonne in dataGridViewColumns ha i valori delle proprietà DisplayIndex e Frozen che ne consentono la visualizzazione in un set di colonne adiacenti con il valore della proprietà Frozen opposto.

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 Windows Forms.

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