DataGridViewColumnCollection.AddRange(DataGridViewColumn[]) Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Добавляет диапазон столбцов в коллекцию.

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

Параметры

dataGridViewColumns

DataGridViewColumn[]

Добавляемый массив объектов DataGridViewColumn.

Исключения

ArgumentNullException

dataGridViewColumns имеет значение null.

InvalidOperationException

Сопоставленный элемент управления DataGridView выполняет одно из следующих действий, временно блокирующих добавление новых столбцов: – выбор всех ячеек элемента управления;

– отмена выбора.

– обновление значений свойств столбца DisplayIndex.

-или- Этот метод вызывается из обработчика для одного из следующих событий DataGridView:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

-или- Среди столбцов dataGridViewColumns по крайней мере один имеет значение null.

-или- По крайней мере один из столбцов dataGridViewColumns уже принадлежит элементу управления DataGridView.

-или- По меньшей мере один из столбцов dataGridViewColumns имеет свойство CellType со значением null, а элемент управления DataGridView содержит хотя бы одну строку.

-или- По меньшей мере один из столбцов dataGridViewColumns имеет свойство SortMode со значением Automatic и свойство SelectionMode со значением FullColumnSelect или ColumnHeaderSelect. Методы ISupportInitialize.BeginInit() и ISupportInitialize.EndInit() элемента управления позволяет временно задавать конфликтующие значения свойств.

-или- По меньшей мере один из столбцов dataGridViewColumns имеет свойство InheritedAutoSizeMode со значением ColumnHeader и свойство ColumnHeadersVisible со значением false.

-или- По меньшей мере один из столбцов dataGridViewColumns имеет свойство InheritedAutoSizeMode со значением Fill и свойство Frozen со значением true.

-или- Столбцы в dataGridViewColumns имеют такие значения свойства FillWeight, в результате которых общее значение FillWeight всех столбцов в элементе управления превышает 65535.

-или- По крайней мере два значения в dataGridViewColumns являются ссылками на один и тот же столбец DataGridViewColumn.

-или- По крайней мере один из столбцов dataGridViewColumns имеет значения свойств DisplayIndex и Frozen, в результате которых столбец будет отображаться среди набора смежных столбцов с противоположным значением свойства Frozen.

Примеры

В следующем примере кода показано использование этого метода. Этот пример является частью более крупного примера, доступного в разделе "Практическое руководство. Настройка режимов изменения размера элемента управления 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."})

См. также раздел

• DataGridView
• DataGridViewColumn