DataGridViewColumnCollection.Add Metodo

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Aggiunge la colonna specificata all'insieme.

Overload

Nome Descrizione
Add(DataGridViewColumn)

Aggiunge la colonna specificata all'insieme.
Add(String, String)

Aggiunge un oggetto DataGridViewTextBoxColumn con il nome della colonna e il testo dell'intestazione di colonna specificati all'insieme.

Add(DataGridViewColumn)

Origine:
DataGridViewColumnCollection.cs
Origine:
DataGridViewColumnCollection.cs
Origine:
DataGridViewColumnCollection.cs
Origine:
DataGridViewColumnCollection.cs
Origine:
DataGridViewColumnCollection.cs

Aggiunge la colonna specificata all'insieme.

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

Parametri

dataGridViewColumn
DataGridViewColumn

Oggetto DataGridViewColumn da aggiungere.

Valori restituiti

Int32

Indice della colonna.

Eccezioni

ArgumentNullException

dataGridViewColumn è null.

InvalidOperationException

Il controllo associato DataGridView esegue una delle azioni seguenti che impedisce temporaneamente l'aggiunta di nuove colonne:

  • Selezione di tutte le celle nel controllo .

  • Cancellazione della selezione.

  • Aggiornamento dei valori delle proprietà della colonna DisplayIndex .

oppure

Questo metodo viene chiamato da un gestore per uno degli eventi seguenti DataGridView :

oppure

dataGridViewColumn appartiene già a un DataGridView controllo .

oppure

Il valore della dataGridViewColumnSortMode proprietà è Automatic e il valore della SelectionMode proprietà è FullColumnSelect o ColumnHeaderSelect. Utilizzare il controllo ISupportInitialize.BeginInit() e ISupportInitialize.EndInit() i metodi per impostare temporaneamente i valori delle proprietà in conflitto.

oppure

Il valore della dataGridViewColumnInheritedAutoSizeMode proprietà è ColumnHeader e il valore della ColumnHeadersVisible proprietà è false.

oppure

dataGridViewColumn ha un InheritedAutoSizeMode valore della proprietà e Fill un Frozen valore della proprietà pari truea .

oppure

dataGridViewColumn ha un FillWeight valore della proprietà che causerebbe il superamento di 65535 dei valori combinati FillWeight di tutte le colonne nel controllo.

oppure

dataGridViewColumn ha DisplayIndex i valori delle proprietà e Frozen che lo visualizzano tra un set di colonne adiacenti con il valore della proprietà opposto Frozen .

oppure

Il DataGridView controllo contiene almeno una riga e dataGridViewColumn ha un CellType valore della proprietà .null

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo metodo.

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

Vedi anche

Si applica a

Add(String, String)

Origine:
DataGridViewColumnCollection.cs
Origine:
DataGridViewColumnCollection.cs
Origine:
DataGridViewColumnCollection.cs
Origine:
DataGridViewColumnCollection.cs
Origine:
DataGridViewColumnCollection.cs

Aggiunge un oggetto DataGridViewTextBoxColumn con il nome della colonna e il testo dell'intestazione di colonna specificati all'insieme.

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 -> int
Public Overridable Function Add (columnName As String, headerText As String) As Integer

Parametri

columnName
String

Nome in base al quale verrà fatto riferimento alla colonna.

headerText
String

Testo per l'intestazione della colonna.

Valori restituiti

Int32

Indice della colonna.

Eccezioni

InvalidOperationException

Il controllo associato DataGridView esegue una delle azioni seguenti che impedisce temporaneamente l'aggiunta di nuove colonne:

  • Selezione di tutte le celle nel controllo .

  • Cancellazione della selezione.

  • Aggiornamento dei valori delle proprietà della colonna DisplayIndex .

oppure

Questo metodo viene chiamato da un gestore per uno degli eventi seguenti DataGridView :

oppure

Il valore della SelectionMode proprietà è FullColumnSelect o ColumnHeaderSelect, che è in conflitto con il valore predefinito della proprietà della colonna SortMode di Automatic.

oppure

Il valore predefinito della proprietà della colonna FillWeight pari a 100 causerebbe che i valori combinati FillWeight di tutte le colonne nel controllo superino i 65535.

Commenti

I columnName parametri e sono correlati rispettivamente alle headerText proprietà e NameHeaderText .

Vedi anche

Si applica a