DataGridViewColumnCollection.Add Méthode
Définition
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 la colonne donnée à la collection.
Surcharges
| Nom | Description |
|---|---|
| Add(DataGridViewColumn) |
Ajoute la colonne donnée à la collection. |
| Add(String, String) |
Ajoute un DataGridViewTextBoxColumn texte avec le nom de colonne et le texte d’en-tête de colonne donnés à la collection. |
Add(DataGridViewColumn)
Ajoute la colonne donnée à la collection.
public:
virtual int Add(System::Windows::Forms::DataGridViewColumn ^ dataGridViewColumn);
public virtual int Add(System.Windows.Forms.DataGridViewColumn dataGridViewColumn);
abstract member Add : System.Windows.Forms.DataGridViewColumn -> int
override this.Add : System.Windows.Forms.DataGridViewColumn -> int
Public Overridable Function Add (dataGridViewColumn As DataGridViewColumn) As Integer
Paramètres
- dataGridViewColumn
- DataGridViewColumn
À DataGridViewColumn ajouter.
Retours
Index de la colonne.
Exceptions
dataGridViewColumn a la valeur null.
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-
dataGridViewColumn appartient déjà à un DataGridView contrôle.
-ou-
La dataGridViewColumnSortMode valeur de la propriété est Automatic et la valeur de SelectionMode la propriété est FullColumnSelect ou ColumnHeaderSelect. Utilisez le contrôle ISupportInitialize.BeginInit() et ISupportInitialize.EndInit() les méthodes pour définir temporairement les valeurs de propriété en conflit.
-ou-
La valeur de dataGridViewColumnInheritedAutoSizeMode la propriété est ColumnHeader et la valeur de la ColumnHeadersVisible propriété est false.
-ou-
dataGridViewColumn a une InheritedAutoSizeMode valeur de propriété et Fill une Frozen valeur de propriété de true.
-ou-
dataGridViewColumn a une FillWeight valeur de propriété qui entraînerait que les valeurs combinées FillWeight de toutes les colonnes du contrôle dépassent 65535.
-ou-
dataGridViewColumn a DisplayIndex et Frozen les valeurs de propriété qui l’affichent parmi un ensemble de colonnes adjacentes avec la valeur de propriété opposée Frozen .
-ou-
Le DataGridView contrôle contient au moins une ligne et dataGridViewColumn a une CellType valeur de propriété .null
Exemples
L’exemple de code suivant illustre l’utilisation de cette méthode.
private DataGridView dataGridView1 = new DataGridView();
private void AddColorColumn()
{
DataGridViewComboBoxColumn comboBoxColumn =
new DataGridViewComboBoxColumn();
comboBoxColumn.Items.AddRange(
Color.Red, Color.Yellow, Color.Green, Color.Blue);
comboBoxColumn.ValueType = typeof(Color);
dataGridView1.Columns.Add(comboBoxColumn);
dataGridView1.EditingControlShowing +=
new DataGridViewEditingControlShowingEventHandler(
dataGridView1_EditingControlShowing);
}
private void dataGridView1_EditingControlShowing(object sender,
DataGridViewEditingControlShowingEventArgs e)
{
ComboBox combo = e.Control as ComboBox;
if (combo != null)
{
// Remove an existing event-handler, if present, to avoid
// adding multiple handlers when the editing control is reused.
combo.SelectedIndexChanged -=
new EventHandler(ComboBox_SelectedIndexChanged);
// Add the event handler.
combo.SelectedIndexChanged +=
new EventHandler(ComboBox_SelectedIndexChanged);
}
}
private void ComboBox_SelectedIndexChanged(object sender, EventArgs e)
{
((ComboBox)sender).BackColor = (Color)((ComboBox)sender).SelectedItem;
}
Private WithEvents dataGridView1 As New DataGridView()
Private Sub AddColorColumn()
Dim comboBoxColumn As New DataGridViewComboBoxColumn()
comboBoxColumn.Items.AddRange( _
Color.Red, Color.Yellow, Color.Green, Color.Blue)
comboBoxColumn.ValueType = GetType(Color)
dataGridView1.Columns.Add(comboBoxColumn)
End Sub
Private Sub dataGridView1_EditingControlShowing(ByVal sender As Object, _
ByVal e As DataGridViewEditingControlShowingEventArgs) _
Handles dataGridView1.EditingControlShowing
Dim combo As ComboBox = CType(e.Control, ComboBox)
If (combo IsNot Nothing) Then
' Remove an existing event-handler, if present, to avoid
' adding multiple handlers when the editing control is reused.
RemoveHandler combo.SelectedIndexChanged, _
New EventHandler(AddressOf ComboBox_SelectedIndexChanged)
' Add the event handler.
AddHandler combo.SelectedIndexChanged, _
New EventHandler(AddressOf ComboBox_SelectedIndexChanged)
End If
End Sub
Private Sub ComboBox_SelectedIndexChanged( _
ByVal sender As Object, ByVal e As EventArgs)
Dim comboBox1 As ComboBox = CType(sender, ComboBox)
comboBox1.BackColor = _
CType(CType(sender, ComboBox).SelectedItem, Color)
End Sub
Voir aussi
S’applique à
Add(String, String)
Ajoute un DataGridViewTextBoxColumn texte avec le nom de colonne et le texte d’en-tête de colonne donnés à la collection.
public:
virtual int Add(System::String ^ columnName, System::String ^ headerText);
public virtual int Add(string columnName, string headerText);
abstract member Add : string * string -> int
override this.Add : string * string -> int
Public Overridable Function Add (columnName As String, headerText As String) As Integer
Paramètres
- columnName
- String
Nom par lequel la colonne sera référencée.
- headerText
- String
Texte de l’en-tête de la colonne.
Retours
Index de la colonne.
Exceptions
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-
La SelectionMode valeur de propriété est FullColumnSelect ou ColumnHeaderSelect, qui est en conflit avec la valeur de propriété de colonne SortMode par défaut de Automatic.
-ou-
La valeur de la propriété de colonne FillWeight par défaut de 100 entraîne la dépassement de 65535 par les valeurs combinées FillWeight de toutes les colonnes du contrôle.
Remarques
Les columnName paramètres et headerText les Name paramètres sont liés respectivement aux propriétés et HeaderText aux propriétés.