Skip to main content
A newer version of this page is available. .
Tab

ASPxGridViewSearchPanelSettings.ColumnNames Property

Specifies the columns to which the search panel filter should be applied.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v18.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 Bootstrap Controls BootstrapGridView
.SettingsSearchPanel.ColumnNames
ASP.NET Web Forms Controls ASPxGridView
.SettingsSearchPanel.ColumnNames
GridViewProperties
.SettingsSearchPanel.ColumnNames
GridViewSettings
.SettingsSearchPanel.ColumnNames
GridViewSettings<RowType>
.SettingsSearchPanel.ColumnNames
MVCxGridView
.SettingsSearchPanel.ColumnNames
MVCxGridViewProperties
.SettingsSearchPanel.ColumnNames

Remarks

Use the ColumnNames property to specify columns to which a search panel filter should be applied. 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.

Example

SearchPanel_ColumnName

<dx:ASPxGridView ID="Grid" runat="server" DataSourceID="GridDataSource">
          <Columns>
               <dx:GridViewDataTextColumn FieldName="ContactName" />
               <dx:GridViewDataTextColumn FieldName="CompanyName"/>
               <dx:GridViewDataTextColumn FieldName="Address" />
               <dx:GridViewDataTextColumn FieldName="City" />
               <dx:GridViewDataTextColumn FieldName="Country" />
          </Columns>
     <SettingsSearchPanel Visible="true" ShowApplyButton="True" ShowClearButton="True" ColumnNames="ContactName; CompanyName" />
     ...
</dx:ASPxGridView>
See Also