DataGridViewColumnCollection.Add Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Lägger till den angivna kolumnen i samlingen.
Överlagringar
| Name | Description |
|---|---|
| Add(DataGridViewColumn) |
Lägger till den angivna kolumnen i samlingen. |
| Add(String, String) |
Lägger till en DataGridViewTextBoxColumn med det angivna kolumnnamnet och kolumnrubriktexten i samlingen. |
Add(DataGridViewColumn)
Lägger till den angivna kolumnen i samlingen.
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 -> intPublic Overridable Function Add (dataGridViewColumn As DataGridViewColumn) As IntegerParametrar
- dataGridViewColumn
- DataGridViewColumn
Att DataGridViewColumn lägga till.
Returer
Indexet för kolumnen.
Undantag
dataGridViewColumn är null.
Den associerade DataGridView kontrollen utför någon av följande åtgärder som tillfälligt förhindrar att nya kolumner läggs till:
Markera alla celler i kontrollen.
Rensa markeringen.
Uppdaterar kolumnegenskapsvärden DisplayIndex .
-eller-
Den här metoden anropas från en hanterare för någon av följande DataGridView händelser:
-eller-
dataGridViewColumn tillhör redan en DataGridView kontroll.
-eller-
Egenskapsvärdet dataGridViewColumnSortMode är Automatic och egenskapsvärdet SelectionMode är FullColumnSelect eller ColumnHeaderSelect. Använd kontrollen ISupportInitialize.BeginInit() och ISupportInitialize.EndInit() metoderna för att tillfälligt ange motstridiga egenskapsvärden.
-eller-
Egenskapsvärdet dataGridViewColumnInheritedAutoSizeMode är ColumnHeader och egenskapsvärdet ColumnHeadersVisible är false.
-eller-
dataGridViewColumn har ett InheritedAutoSizeMode egenskapsvärde och Fill ett Frozen egenskapsvärde på true.
-eller-
dataGridViewColumn har ett FillWeight egenskapsvärde som gör att de kombinerade FillWeight värdena för alla kolumner i kontrollen överskrider 65535.
-eller-
dataGridViewColumn har DisplayIndex och Frozen egenskapsvärden som visar den bland en uppsättning intilliggande kolumner med det motsatta Frozen egenskapsvärdet.
-eller-
Kontrollen DataGridView innehåller minst en rad och dataGridViewColumn har ett CellType egenskapsvärde på null.
Exempel
Följande kodexempel illustrerar användningen av den här metoden.
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
Se även
Gäller för
Add(String, String)
Lägger till en DataGridViewTextBoxColumn med det angivna kolumnnamnet och kolumnrubriktexten i samlingen.
public:
virtual int Add(System::String ^ columnName, System::String ^ headerText);public virtual int Add(string columnName, string headerText);public virtual int Add(string? columnName, string? headerText);abstract member Add : string * string -> int
override this.Add : string * string -> intPublic Overridable Function Add (columnName As String, headerText As String) As IntegerParametrar
- columnName
- String
Namnet som kolumnen ska refereras till.
- headerText
- String
Texten för kolumnens rubrik.
Returer
Indexet för kolumnen.
Undantag
Den associerade DataGridView kontrollen utför någon av följande åtgärder som tillfälligt förhindrar att nya kolumner läggs till:
Markera alla celler i kontrollen.
Rensa markeringen.
Uppdaterar kolumnegenskapsvärden DisplayIndex .
-eller-
Den här metoden anropas från en hanterare för någon av följande DataGridView händelser:
-eller-
Egenskapsvärdet SelectionMode är FullColumnSelect eller ColumnHeaderSelect, vilket står i konflikt med standardvärdet för kolumnegenskapen SortModeAutomaticför .
-eller-
Standardvärdet för kolumnegenskapen FillWeight 100 skulle göra att de kombinerade FillWeight värdena för alla kolumner i kontrollen överskrider 65535.
Kommentarer
Parametrarna columnName och headerText är relaterade till Name egenskaperna och HeaderText .
