# Columns::getSelect()

URL: https://chugunov.pro/api-bitrix/main/grid/column/columns/getselect/
Проверено на 1С-Битрикс 25.x, обновлено 03.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией 1С-Битрикс.

Класс: [`\Bitrix\Main\Grid\Column\Columns`](https://chugunov.pro/api-bitrix/main/grid/column/columns/)
Модуль: Main.
Свойства элемента: method, public.

## Сигнатура

```php
public getSelect([array<string|int, string>|null $columnIds = null ][, array<string|int, string>|null $providers = null ]) : array<string|int, string>
```

## Описание

Один столбец может использовать несколько полей в запросе.
Необходимые столбцы также будут возвращены, даже если они не указаны в аргументах (с учётом фильтрации по провайдерам).

Все столбцы всех провайдеров:

$ormSelect = $columns->getSelect();

Фильтр по столбцам (типичное использование: показать только видимые столбцы):

$ormSelect = $columns->getSelect(
$grid->getVisibleColumnsIds()
);

Фильтр по провайдерам (например: грид содержит столбцы из разных таблиц):

$elementSelect = $columns->getSelect(null, [
\Bitrix\Iblock\Grid\Column\ElementProvider::class,
\Bitrix\Iblock\Grid\Column\ElementPropertyProvider::class,
]);

$catalogSelect = $columns->getSelect(null, [
\Bitrix\Catalog\Grid\Column\ProductProvider::class,
\Bitrix\Catalog\Grid\Column\PriceProvider::class,
]);

И оба фильтра:

$elementSelect = $columns->getSelect(
$grid->getVisibleColumnsIds(),
[
\Bitrix\Iblock\Grid\Column\ElementProvider::class,
\Bitrix\Iblock\Grid\Column\ElementPropertyProvider::class,
]
);

## Параметры

- `$columnIds` `array<string|int, string>|null` — необязательный, по умолчанию `null`. если null, возвращаются все столбцы.
- `$providers` `array<string|int, string>|null` — необязательный, по умолчанию `null`. массив с полными именами классов провайдеров.
  Если заполнен, столбцы будут взяты только из указанных провайдеров.
  ВНИМАНИЕ: необходимые столбцы из других провайдеров НЕ БУДУТ ВКЛЮЧЕНЫ в результат!

## Возвращаемое значение

`array<string|int, string>`

Оригинал в официальной документации: https://docs.1c-bitrix.ru/api/classes/Bitrix-Main-Grid-Column-Columns.html