DataGridViewColumnCollection.AddRange(DataGridViewColumn[]) Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

DataGridViewColumnCollection.cs

Koleksiyona bir sütun aralığı ekler.

public:
 virtual void AddRange(... cli::array <System::Windows::Forms::DataGridViewColumn ^> ^ dataGridViewColumns);

public virtual void AddRange(params System.Windows.Forms.DataGridViewColumn[] dataGridViewColumns);

abstract member AddRange : System.Windows.Forms.DataGridViewColumn[] -> unit
override this.AddRange : System.Windows.Forms.DataGridViewColumn[] -> unit

Public Overridable Sub AddRange (ParamArray dataGridViewColumns As DataGridViewColumn())

Parametreler

dataGridViewColumns

DataGridViewColumn[]

Eklenecek nesne dizisi DataGridViewColumn .

Özel durumlar

ArgumentNullException

dataGridViewColumns, 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-

içindeki dataGridViewColumns değerlerden en az biri olur null.

-veya-

içindeki dataGridViewColumns sütunlardan en az biri zaten bir DataGridView denetime ait.

-veya-

içindeki dataGridViewColumns sütunlardan en az birinin özellik değeri CellType vardır null ve DataGridView denetim en az bir satır içerir.

-veya-

içindeki dataGridViewColumns sütunlardan en az birinin özellik değeri SortMode vardır Automatic ve SelectionMode özellik değeri veya FullColumnSelectolurColumnHeaderSelect. Çakışan özellik değerlerini geçici olarak ayarlamak için denetimi ISupportInitialize.BeginInit() ve ISupportInitialize.EndInit() yöntemleri kullanın.

-veya-

içindeki dataGridViewColumns sütunlardan en az birinin özellik değeri InheritedAutoSizeMode vardır ColumnHeader ve ColumnHeadersVisible özellik değeri olurfalse.

-veya-

içindeki dataGridViewColumnsInheritedAutoSizeMode sütunlardan en az birinin özellik değeri Fill ve Frozen özellik değeri vardır true.

-veya-

içindeki dataGridViewColumns sütunların, denetimdeki tüm sütunların birleşik FillWeight değerlerinin 65535'i aşmasına neden olacak özellik değerleri vardırFillWeight.

-veya-

içindeki dataGridViewColumns değerlerden en az ikisi aynı DataGridViewColumnöğesine başvurulardır.

-veya-

içindeki dataGridViewColumns sütunlardan en az biri, bunu karşı DisplayIndex özellik değerine sahip bitişik sütunlar arasında görüntüleyen ve Frozen özellik değerlerine sahiptirFrozen.

Örnekler

Aşağıdaki kod örneğinde bu yöntemin kullanımı gösterilmektedir. Bu örnek, Nasıl yapılır: Windows Forms DataGridView Denetiminin Boyutlandırma Modlarını Ayarlama bölümünde bulunan daha büyük bir örneğin parçasıdır.

dataGridView1.Columns.AddRange(new DataGridViewTextBoxColumn[] { 
    idColumn, titleColumn, subTitleColumn, 
    summaryColumn, contentColumn });
dataGridView1.Rows.Add(new String[] { "1", 
    "A Short Title", "A Longer SubTitle", 
    "A short description of the main point.", 
    "The full contents of the topic, with detailed examples." });

dataGridView1.Columns.AddRange(New DataGridViewTextBoxColumn() { _
    idColumn, titleColumn, subTitleColumn, _
    summaryColumn, contentColumn})
dataGridView1.Rows.Add(New String() {"1", _
    "A Short Title", "A Longer SubTitle", _
    "A short description of the main point.", _
    "The full contents of the topic, with detailed examples."})

Ayrıca bkz.

• DataGridView
• DataGridViewColumn