DataGridViewColumnCollection.Add Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Dodaje daną kolumnę do kolekcji.

Przeciążenia

Add(DataGridViewColumn)	Dodaje daną kolumnę do kolekcji.
Add(String, String)	Dodaje element DataGridViewTextBoxColumn z daną nazwą kolumny i tekstem nagłówka kolumny do kolekcji.

Add(DataGridViewColumn)

Dodaje daną kolumnę do kolekcji.

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

Element do dodania DataGridViewColumn .

Zwraca

Int32

Indeks kolumny.

Wyjątki

ArgumentNullException

dataGridViewColumn to null.

InvalidOperationException

Skojarzona DataGridView kontrolka wykonuje jedną z następujących akcji, które tymczasowo uniemożliwiają dodawanie nowych kolumn: — Zaznaczanie wszystkich komórek w kontrolce.

• Wyczyszczenie zaznaczenia.

— Aktualizowanie wartości właściwości kolumny DisplayIndex .

-lub- Ta metoda jest wywoływana z programu obsługi dla jednego z następujących DataGridView zdarzeń:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-lub- dataGridViewColumn należy już do kontrolki DataGridView .

-lub- Wartość dataGridViewColumnSortMode właściwości to Automatic , a SelectionMode wartość właściwości to FullColumnSelect lub ColumnHeaderSelect. Użyj kontrolki ISupportInitialize.BeginInit() i ISupportInitialize.EndInit() metod, aby tymczasowo ustawić wartości właściwości powodujące konflikt.

-lub- Wartość dataGridViewColumnInheritedAutoSizeMode właściwości to ColumnHeader , a ColumnHeadersVisible wartość właściwości to false.

-lub- dataGridViewColumnInheritedAutoSizeMode ma wartość Fill właściwości i Frozen wartość właściwości .true

-lub- dataGridViewColumnFillWeight ma wartość właściwości, która spowoduje, że łączne FillWeight wartości wszystkich kolumn w kontrolce przekraczają 65535.

-lub- dataGridViewColumn ma DisplayIndex wartości właściwości i Frozen , które wyświetlałyby go wśród zestawu sąsiednich kolumn z przeciwną Frozen wartością właściwości.

-lub- Kontrolka DataGridView zawiera co najmniej jeden wiersz i dataGridViewColumn ma CellType wartość nullwłaściwości .

Przykłady

Poniższy przykład kodu ilustruje użycie tej 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

Zobacz też

• DataGridView
• DataGridViewColumn

Add(String, String)

Dodaje element DataGridViewTextBoxColumn z daną nazwą kolumny i tekstem nagłówka kolumny do kolekcji.

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

Nazwa, za pomocą której zostanie odwołana kolumna.

headerText

String

Tekst nagłówka kolumny.

Zwraca

Int32

Indeks kolumny.

Wyjątki

InvalidOperationException

Skojarzona DataGridView kontrolka wykonuje jedną z następujących akcji, które tymczasowo uniemożliwiają dodawanie nowych kolumn: — Zaznaczanie wszystkich komórek w kontrolce.

• Wyczyszczenie zaznaczenia.

— Aktualizowanie wartości właściwości kolumny DisplayIndex .

-lub- Ta metoda jest wywoływana z programu obsługi dla jednego z następujących DataGridView zdarzeń:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-lub- Wartość SelectionMode właściwości to FullColumnSelect lub ColumnHeaderSelect, która powoduje konflikt z domyślną wartością właściwości kolumny SortMode .Automatic

-lub- Domyślna wartość właściwości kolumny FillWeight 100 spowoduje, że łączne FillWeight wartości wszystkich kolumn w kontrolce przekraczają 65535.

Uwagi

Parametry columnName i headerText są powiązane odpowiednio z Name właściwościami i HeaderText .

Zobacz też

• DataGridView
• DataGridViewColumn