DataGridViewColumnCollection.AddRange(DataGridViewColumn[]) Méthode

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Ajoute une plage de colonnes à la collection.

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

Paramètres

dataGridViewColumns: DataGridViewColumn[]

Tableau d'objets DataGridViewColumn à ajouter.

Exceptions

ArgumentNullException

dataGridViewColumns a la valeur null.

InvalidOperationException

Le contrôle DataGridView associé exécute l'une des opérations suivantes qui empêchent temporairement l'ajout de nouvelles colonnes :

Sélection de toutes les cellules contenues dans le contrôle.
Effacement de la sélection.
Mise à jour des valeurs de propriété DisplayIndex de la colonne.
ou - Cette méthode est appelée à partir d’un gestionnaire d’un des événements DataGridView suivants :
CellEnter
CellLeave
CellValidating
CellValidated
RowEnter
RowLeave
RowValidated
RowValidating
ou - Au moins une des valeurs de dataGridViewColumns est null.
ou - Au moins une des colonnes de dataGridViewColumns appartient déjà à un contrôle DataGridView.
ou - Au moins une des colonnes de dataGridViewColumns a une valeur de propriété CellType de null et le contrôle DataGridView contient au moins une ligne.
ou - Au moins une des colonnes de dataGridViewColumns a une valeur de propriété SortMode de Automatic et la valeur de propriété SelectionMode est FullColumnSelect ou ColumnHeaderSelect. Utilisez les méthodes ISupportInitialize.BeginInit() et ISupportInitialize.EndInit() du contrôle pour définir temporairement des valeurs de propriétés en conflit.
ou - Au moins une des colonnes de dataGridViewColumns a une valeur de propriété InheritedAutoSizeMode de ColumnHeader et la valeur de propriété ColumnHeadersVisible est false.
ou - Au moins une des colonnes de dataGridViewColumns a une valeur de propriété InheritedAutoSizeMode de Fill et une valeur de propriété Frozen de true.
ou - Les colonnes de dataGridViewColumns ont des valeurs de propriété FillWeight qui feraient en sorte que les valeurs FillWeight combinées de toutes les colonnes dans le contrôle dépassent 65 535.
ou - Au moins deux des valeurs de dataGridViewColumns sont des références au même DataGridViewColumn.
ou - Au moins une des colonnes de dataGridViewColumns a des valeurs de propriété DisplayIndex et Frozen qui l'afficheraient parmi un jeu de colonnes adjacentes avec la valeur de propriété Frozen opposée.

Exemples

L’exemple de code suivant illustre l’utilisation de cette méthode. Cet exemple fait partie d’un exemple plus large disponible dans 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."})

S’applique à