DataGridViewColumnCollection.Add Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Přidá daný sloupec do kolekce.

Přetížení

Add(DataGridViewColumn)	Přidá daný sloupec do kolekce.
Add(String, String)	DataGridViewTextBoxColumn Přidá do kolekce objekt s daným názvem sloupce a textem záhlaví sloupce.

Add(DataGridViewColumn)

Přidá daný sloupec do kolekce.

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

Parametry

dataGridViewColumn

DataGridViewColumn

Přidá DataGridViewColumn se.

Návraty

Int32

Index sloupce

Výjimky

ArgumentNullException

dataGridViewColumn je null.

InvalidOperationException

Přidružený DataGridView ovládací prvek provádí jednu z následujících akcí, která dočasně brání přidání nových sloupců:

• Výběr všech buněk v ovládacím prvku

• Vymazání výběru

• Aktualizují se hodnoty vlastností sloupce DisplayIndex .

-nebo-

Tato metoda je volána z obslužné rutiny pro jednu z následujících DataGridView událostí:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-nebo-

dataGridViewColumn již patří k ovládacímu prvku DataGridView .

-nebo-

Hodnota dataGridViewColumnSortMode vlastnosti je Automatic a SelectionMode hodnota vlastnosti je FullColumnSelect nebo ColumnHeaderSelect. K dočasnému nastavení konfliktních hodnot vlastností použijte ovládací prvky ISupportInitialize.BeginInit() a ISupportInitialize.EndInit() metody.

-nebo-

Hodnota dataGridViewColumnInheritedAutoSizeMode vlastnosti je ColumnHeader a ColumnHeadersVisible hodnota vlastnosti je false.

-nebo-

dataGridViewColumn InheritedAutoSizeMode má hodnotu vlastnosti a FillFrozen hodnotu truevlastnosti .

-nebo-

dataGridViewColumn FillWeight má hodnotu vlastnosti, která by způsobila, že kombinované FillWeight hodnoty všech sloupců v ovládacím prvku překročí 65535.

-nebo-

dataGridViewColumn has DisplayIndex a Frozen hodnoty vlastností, které by je zobrazily mezi sadou sousedních sloupců s opačnou Frozen hodnotou vlastnosti.

-nebo-

Ovládací DataGridView prvek obsahuje alespoň jeden řádek a dataGridViewColumn má CellType hodnotu nullvlastnosti .

Příklady

Následující příklad kódu ukazuje použití této metody.

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

Viz také

• DataGridView
• DataGridViewColumn

Add(String, String)

DataGridViewTextBoxColumn Přidá do kolekce objekt s daným názvem sloupce a textem záhlaví sloupce.

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

Parametry

columnName

String

Název, kterým bude sloupec odkazován.

headerText

String

Text záhlaví sloupce

Návraty

Int32

Index sloupce

Výjimky

InvalidOperationException

Přidružený DataGridView ovládací prvek provádí jednu z následujících akcí, která dočasně brání přidání nových sloupců:

• Výběr všech buněk v ovládacím prvku

• Vymazání výběru

• Aktualizují se hodnoty vlastností sloupce DisplayIndex .

-nebo-

Tato metoda je volána z obslužné rutiny pro jednu z následujících DataGridView událostí:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-nebo-

Hodnota SelectionMode vlastnosti je FullColumnSelect nebo ColumnHeaderSelect, což je v konfliktu s výchozí hodnotou Automaticvlastnosti sloupce SortMode .

-nebo-

Výchozí hodnota vlastnosti sloupce FillWeight 100 způsobí, že kombinované FillWeight hodnoty všech sloupců v ovládacím prvku překročí 65535.

Poznámky

Parametry columnName a headerText souvisejí s vlastnostmi Name a HeaderText v uvedeném pořadí.

Viz také

• DataGridView
• DataGridViewColumn