DataGridViewColumnCollection.Add Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Verilen sütunu koleksiyona ekler.

Aşırı Yüklemeler

Add(DataGridViewColumn)	Verilen sütunu koleksiyona ekler.
Add(String, String)	Koleksiyona verilen sütun adı ve sütun üst bilgisi metniyle bir DataGridViewTextBoxColumn ekler.

Add(DataGridViewColumn)

Verilen sütunu koleksiyona ekler.

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

Parametreler

dataGridViewColumn

DataGridViewColumn

DataGridViewColumn Eklenecek.

Döndürülenler

Int32

Sütunun dizini.

Özel durumlar

ArgumentNullException

dataGridViewColumn, null değeridir.

InvalidOperationException

İlişkili DataGridView denetim, yeni sütunların eklenmesini geçici olarak engelleyen aşağıdaki eylemlerden birini gerçekleştiriyor:

• Denetimdeki tüm hücreleri seçme.

• Seçimi temizleme.

• Sütun DisplayIndex özelliği değerleri güncelleştiriliyor.

-veya-

Bu yöntem, aşağıdaki DataGridView olaylardan biri için bir işleyiciden çağrılır:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-veya-

dataGridViewColumn zaten bir DataGridView denetime ait.

-veya-

Özellik dataGridViewColumnSortMode değeri ve AutomaticSelectionMode özellik değeri veya ColumnHeaderSelectşeklindedirFullColumnSelect. Çakışan özellik değerlerini geçici olarak ayarlamak için denetimi ISupportInitialize.BeginInit() ve ISupportInitialize.EndInit() yöntemleri kullanın.

-veya-

Özellik dataGridViewColumnInheritedAutoSizeMode değeri, ColumnHeaderColumnHeadersVisible özellik değeri ise şeklindedir false.

-veya-

dataGridViewColumnInheritedAutoSizeMode özelliği değerine Fill ve Frozen özellik değerine truesahiptir.

-veya-

dataGridViewColumndenetimdeki tüm sütunların birleşik FillWeight değerlerinin 65535'i aşmasına neden olacak bir FillWeight özellik değerine sahiptir.

-veya-

dataGridViewColumn has DisplayIndex ve Frozen özellik değerleri, bunu karşı Frozen özellik değerine sahip bir dizi bitişik sütun arasında görüntüleyecek.

-veya-

Denetim DataGridView en az bir satır içerir ve dataGridViewColumn özelliği değerine nullsahiptirCellType.

Örnekler

Aşağıdaki kod örneğinde bu yöntemin kullanımı gösterilmektedir.

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

Ayrıca bkz.

• DataGridView
• DataGridViewColumn

Add(String, String)

Koleksiyona verilen sütun adı ve sütun üst bilgisi metniyle bir DataGridViewTextBoxColumn ekler.

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

Parametreler

columnName

String

Sütunun başvuracağı ad.

headerText

String

Sütunun üst bilgisinin metni.

Döndürülenler

Int32

Sütunun dizini.

Özel durumlar

InvalidOperationException

İlişkili DataGridView denetim, yeni sütunların eklenmesini geçici olarak engelleyen aşağıdaki eylemlerden birini gerçekleştiriyor:

• Denetimdeki tüm hücreleri seçme.

• Seçimi temizleme.

• Sütun DisplayIndex özelliği değerleri güncelleştiriliyor.

-veya-

Bu yöntem, aşağıdaki DataGridView olaylardan biri için bir işleyiciden çağrılır:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-veya-

Özellik SelectionMode değeri veya ColumnHeaderSelectdeğeridir FullColumnSelect ve varsayılan sütun SortMode özelliği değeriyle Automaticçakılır.

-veya-

Varsayılan sütun FillWeight özelliği değeri olan 100, denetimdeki tüm sütunların birleşik FillWeight değerlerinin 65535'i aşmasına neden olabilir.

Açıklamalar

columnName ve headerText parametreleri sırasıyla ve HeaderText özellikleriyle Name ilgilidir.

Ayrıca bkz.

• DataGridView
• DataGridViewColumn