DataGridViewColumnCollection.Add Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Přidá daný sloupec do kolekce.

Přetížení

Name	Description
Add(DataGridViewColumn)	Přidá daný sloupec do kolekce.
Add(String, String)	DataGridViewTextBoxColumn Přidá do kolekce text záhlaví se zadaným názvem sloupce a záhlavím sloupce.

Add(DataGridViewColumn)

Zdroj:

DataGridViewColumnCollection.cs

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ání DataGridViewColumn

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.

• Aktualizace hodnot vlastností sloupce DisplayIndex

nebo

Tato metoda se volá 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ří do DataGridView ovládacího prvku.

nebo

Hodnota dataGridViewColumnSortMode vlastnosti je Automatic a SelectionMode hodnota vlastnosti je FullColumnSelect nebo ColumnHeaderSelect. Pomocí ovládacího prvku ISupportInitialize.BeginInit() a ISupportInitialize.EndInit() metod dočasně nastavte konfliktní hodnoty vlastností.

nebo

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

nebo

dataGridViewColumn InheritedAutoSizeMode má hodnotu Fill vlastnosti a Frozen 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 obsahuje DisplayIndex hodnoty vlastností Frozen , které by se 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)

Zdroj:

DataGridViewColumnCollection.cs

DataGridViewTextBoxColumn Přidá do kolekce text záhlaví se zadaným názvem sloupce a záhlavím 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, podle kterého 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.

• Aktualizace hodnot vlastností sloupce DisplayIndex

nebo

Tato metoda se volá 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, která je v konfliktu s výchozí hodnotou SortModevlastnosti sloupce Automatic .

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

columnName Parametry headerText souvisejí s Name vlastnostmi a HeaderText vlastnostmi.

Viz také

• DataGridView
• DataGridViewColumn