DataGridViewColumnCollection.AddRange(DataGridViewColumn[]) Méthode

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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 associé DataGridView effectue l’une des actions suivantes qui empêchent temporairement l’ajout de nouvelles colonnes :

  • Sélection de toutes les cellules du contrôle.

  • Effacement de la sélection.

  • Mise à jour des valeurs de propriété de colonne DisplayIndex .

-ou-

Cette méthode est appelée à partir d’un gestionnaire pour l’un des événements suivants DataGridView :

-ou-

Au moins une des valeurs dans dataGridViewColumns est null.

-ou-

Au moins une des colonnes d’un dataGridViewColumns contrôle appartient déjà à un DataGridView contrôle.

-ou-

Au moins une des colonnes présente dataGridViewColumns une valeur de null propriété et le DataGridView contrôle contient au CellType moins une ligne.

-ou-

Au moins une des colonnes présente dataGridViewColumns une valeur de Automatic propriété et la valeur de la SelectionMode propriété est FullColumnSelect ou ColumnHeaderSelect.SortMode Utilisez le contrôle ISupportInitialize.BeginInit() et ISupportInitialize.EndInit() les méthodes pour définir temporairement les valeurs de propriété en conflit.

-ou-

Au moins une des colonnes présente dataGridViewColumns une valeur de ColumnHeader propriété et la valeur de la ColumnHeadersVisible propriété est falseInheritedAutoSizeMode .

-ou-

Au moins une des colonnes présente dataGridViewColumns une valeur de Fill propriété et une Frozen valeur de propriété .trueInheritedAutoSizeMode

-ou-

Les colonnes dans dataGridViewColumns lesquelles elles ont FillWeight des valeurs de propriété qui entraîneraient le dépassement de 65535 des valeurs combinées FillWeight de toutes les colonnes du contrôle.

-ou-

Au moins deux des valeurs contenues dataGridViewColumns sont des références au même DataGridViewColumn.

-ou-

Au moins une des colonnes présentes et dataGridViewColumnsDisplayIndexFrozen des valeurs de propriété qui l’affichent parmi un ensemble de colonnes adjacentes avec la valeur de propriété opposée.Frozen

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 à

Voir aussi