DataGridViewColumnCollection.Add Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Aggiunge all'insieme la colonna specificata.

Overload

Add(DataGridViewColumn)	Aggiunge all'insieme la colonna specificata.
Add(String, String)	Aggiunge all'insieme un oggetto DataGridViewTextBoxColumn con il nome e il testo di intestazione della colonna specificati.

Add(DataGridViewColumn)

Aggiunge all'insieme la colonna specificata.

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.

Restituisce

Int32

Indice della colonna.

Eccezioni

ArgumentNullException

dataGridViewColumn è null.

InvalidOperationException

Il controllo DataGridView associato sta eseguendo una delle azioni riportate di seguito che impedisce temporaneamente di aggiungere 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 di DataGridView seguenti:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-oppure-

dataGridViewColumn appartiene già a un controllo DataGridView.

-oppure-

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

-oppure-

Il valore della proprietà InheritedAutoSizeMode di dataGridViewColumn è ColumnHeader, mentre il valore della proprietà ColumnHeadersVisible è false.

-oppure-

Il valore della proprietà InheritedAutoSizeMode del parametro dataGridViewColumn è Fill mentre il valore della proprietà Frozen è true.

-oppure-

Il valore della proprietà FillWeight del parametro dataGridViewColumn determina che i valori combinati della proprietà FillWeight di tutte le colonne del controllo siano superiori a 65535.

-oppure-

Il parametro dataGridViewColumn ha i valori delle proprietà DisplayIndex e Frozen che ne consentono la visualizzazione in un set di colonne adiacenti con il valore della proprietà Frozen opposto.

-oppure-

Il controllo DataGridView contiene almeno una riga e il valore della proprietà CellType del parametro dataGridViewColumn è 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

• DataGridView
• DataGridViewColumn

Add(String, String)

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

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

Parametri

columnName

String

Nome con il quale verrà indicata la colonna.

headerText

String

Testo dell'intestazione della colonna.

Restituisce

Int32

Indice della colonna.

Eccezioni

InvalidOperationException

Il controllo DataGridView associato sta eseguendo una delle azioni riportate di seguito che impedisce temporaneamente di aggiungere 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 di DataGridView seguenti:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-oppure-

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

-oppure-

Il valore 100 della proprietà FillWeight della colonna predefinita fa sì che la somma dei valori di FillWeight di tutte le colonne nel controllo superi 65535.

Commenti

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

Vedi anche

• DataGridView
• DataGridViewColumn