Tab

ASPxGridViewSearchPanelSettings.ColumnNames Property

Specifies the columns to which the grid should apply the search panel filter.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v20.2.dll

Declaration

[DefaultValue("*")]
public string ColumnNames { get; set; }

Property Value

Type Default Description
String

"*"

A string value listing grid column identifiers that can be either: column name, field name, or caption.

Property Paths

You can access this nested property as listed below:

Library Object Type Path to ColumnNames
ASP.NET Controls and MVC Extensions ASPxGridView
.SettingsSearchPanel.ColumnNames
GridViewProperties
.SettingsSearchPanel.ColumnNames
ASP.NET Bootstrap Controls BootstrapGridView
.SettingsSearchPanel.ColumnNames
ASP.NET MVC Extensions GridViewSettings
.SettingsSearchPanel.ColumnNames
GridViewSettings<RowType>
.SettingsSearchPanel.ColumnNames
MVCxGridView
.SettingsSearchPanel.ColumnNames
MVCxGridViewProperties
.SettingsSearchPanel.ColumnNames
MVCxGridViewProperties
.SettingsSearchPanel.ColumnNames

Remarks

Use the ColumnNames property to specify columns to which the grid should apply the search panel filter. The specified strings can be either: a column name (WebColumnBase.Name), field name (GridViewDataColumn.FieldName), or caption(WebColumnBase.Caption).

You can exclude a particular column from the filter by setting the column's GridDataColumnSettings.AllowFilterBySearchPanel property to false.

Web Forms:

<dx:ASPxGridView ID="Grid" runat="server" DataSourceID="GridDataSource">
    <Columns>
        <dx:GridViewDataTextColumn FieldName="Country">
            <Settings AllowFilterBySearchPanel="false" />
        </dx:GridViewDataTextColumn>
        ...
    </Columns>
    <SettingsSearchPanel Visible="true" />
</dx:ASPxGridView>

MVC:

@Html.DevExpress().GridView(settings => {
    settings.Name = "grid";
    settings.Columns.Add(column => {
        column.FieldName = "Country";
        column.Settings.AllowFilterBySearchPanel = DefaultBoolean.False;
    });
    settings.SettingsSearchPanel.Visible = true;
    ...
}).Bind(Model).GetHtml()

Concept

Online Demos

Examples

SearchPanel_ColumnName

Web Forms:

<dx:ASPxGridView ID="Grid" runat="server" DataSourceID="GridDataSource">
    <SettingsSearchPanel Visible="true" ShowApplyButton="True" ShowClearButton="True" ColumnNames="ContactName; CompanyName" />
</dx:ASPxGridView>

MVC:

@Html.DevExpress().GridView(settings => {
    settings.Name = "grid";
    settings.SettingsSearchPanel.Visible = true;
    settings.SettingsSearchPanel.ShowApplyButton = true;
    settings.SettingsSearchPanel.ShowClearButton = true;
    settings.SettingsSearchPanel.ColumnNames = "ContactName; CompanyName";
    ...
}).Bind(Model).GetHtml()
See Also