Aracılığıyla paylaş


DataGridViewColumnCollection.AddRange(DataGridViewColumn[]) Yöntem

Tanım

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

dataGridViewColumns, null değeridir.

İ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ç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:

-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 null vardır CellType ve DataGridView denetim en az bir satır içerir.

-veya- içindeki dataGridViewColumns sütunlardan en az birinin özellik değeri Automatic vardır SortMode ve SelectionMode özellik değeri veya ColumnHeaderSelectolurFullColumnSelect. Ç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 ColumnHeader vardır InheritedAutoSizeMode ve ColumnHeadersVisible özellik değeri olurfalse.

-veya- içindeki dataGridViewColumns InheritedAutoSizeMode 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şı Frozen özellik değerine sahip bir dizi bitişik sütun arasında görüntüleyen ve Frozen özellik değerlerine sahiptirDisplayIndex.

Örnekler

Aşağıdaki kod örneği bu yöntemin kullanımını göstermektedir. 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."})

Şunlara uygulanır

Ayrıca bkz.