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

Name	Description
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)

Kaynak:

DataGridViewColumnCollection.cs

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'e eşittir.

InvalidOperationException

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

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

• Seçim temizleniyor.

• 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 FullColumnSelectşeklindedirColumnHeaderSelect. Ç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-

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

-veya-

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

-veya-

dataGridViewColumn has DisplayIndex and 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 CellTypesahiptirnull.

Ö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)

Kaynak:

DataGridViewColumnCollection.cs

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şvurulacağı 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ştirmektedir:

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

• Seçim temizleniyor.

• 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 FullColumnSelectşeklindedir ColumnHeaderSelect 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 Name özellikleriyle HeaderText ilgilidir.

Ayrıca bkz.

• DataGridView
• DataGridViewColumn