Udostępnij za pośrednictwem


DataGridViewColumnCollection.AddRange(DataGridViewColumn[]) Metoda

Definicja

Dodaje do kolekcji zakres kolumn.

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

Parametry

dataGridViewColumns
DataGridViewColumn[]

Tablica obiektów do dodania DataGridViewColumn .

Wyjątki

dataGridViewColumns to null.

Skojarzona DataGridView kontrolka wykonuje jedną z następujących akcji, które tymczasowo uniemożliwiają dodawanie nowych kolumn: — Zaznaczanie wszystkich komórek w kontrolce.

  • Wyczyszczenie zaznaczenia.

— Aktualizowanie wartości właściwości kolumny DisplayIndex .

-lub- Ta metoda jest wywoływana z programu obsługi dla jednego z następujących DataGridView zdarzeń:

-lub- Co najmniej jedna z wartości w pliku dataGridViewColumns to null.

-lub- Co najmniej jedna z kolumn w dataGridViewColumns programie już należy do kontrolki DataGridView .

-lub- Co najmniej jedna z kolumn w pliku dataGridViewColumns ma CellType wartość null właściwości, a kontrolka DataGridView zawiera co najmniej jeden wiersz.

-lub- Co najmniej jedna z kolumn w pliku dataGridViewColumns ma SortMode wartość Automatic właściwości , a SelectionMode wartość właściwości to FullColumnSelect lub ColumnHeaderSelect. Użyj kontrolki ISupportInitialize.BeginInit() i ISupportInitialize.EndInit() metod, aby tymczasowo ustawić wartości właściwości powodujące konflikt.

-lub- Co najmniej jedna z kolumn w pliku dataGridViewColumns ma InheritedAutoSizeMode wartość ColumnHeader właściwości , a ColumnHeadersVisible wartość właściwości to false.

-lub- Co najmniej jedna z kolumn w pliku dataGridViewColumns ma InheritedAutoSizeMode wartość Fill właściwości i Frozen wartość właściwości .true

-lub- Kolumny w dataGridViewColumns kolumnach mają FillWeight wartości właściwości, które mogłyby spowodować, że łączne FillWeight wartości wszystkich kolumn w kontrolce przekraczają 65535.

-lub- Co najmniej dwie wartości w pliku dataGridViewColumns są odwołaniami do tego samego DataGridViewColumnelementu .

-lub- Co najmniej jedna z kolumn w pliku dataGridViewColumns zawiera DisplayIndex wartości właściwości i Frozen , które wyświetlałyby je wśród zestawu sąsiednich kolumn z przeciwną Frozen wartością właściwości.

Przykłady

Poniższy przykład kodu ilustruje użycie tej metody. Ten przykład jest częścią większego przykładu dostępnego w temacie Instrukcje: ustawianie trybów określania rozmiaru kontrolki Windows Forms DataGridView.

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."})

Dotyczy

Zobacz też