Skip to content

Commit 5680302

Browse files
docs(mccm): add info on requests and server filtering
1 parent 203168d commit 5680302

File tree

1 file changed

+9
-3
lines changed

1 file changed

+9
-3
lines changed

controls/multicolumncombobox/functionality/filtering.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,13 +13,16 @@ position: 2
1313
**RadMultiColumnComboBox** lets the user type a search query in the input and it will filter the data source so only relevant items are shown. By default, the filter operation is performed on the client, over the current data. You can also use [server filtering](#server-filtering).
1414

1515
To enable filtering:
16+
1617
1. set the `Filter` property to the desired filter operation:
18+
1719
* `contains`
1820
* `startsWith`
1921
* `endsWith`
2022
* `eq`
2123

2224
Setting it to `none` will disable filtering.
25+
2326
2. set the `FilterFields` property to a comma-separated list of the data source fields whose values you want to be used for comparing against the user input
2427

2528
The `MinLength` property defines the minimum input length before the filter operation is performed.
@@ -58,13 +61,16 @@ When you set the `EnableServerFiltering` property to `true`, filtering will requ
5861

5962
This can be useful when there is a lot of data that would slow down the browser by creating a lot of elements, or would be costly to the server. Combined with `MinLength`, you can improve the performance for both the client, and the server.
6063

61-
The server filtering requires binding to a web service, and it will result in GET requests where querystring parameters will denote the filtered field and operator. For example, if the `ProductName` field is set as the `DataValueField`, `Filter` is `contains` and the user inut us `che`, the parameter added to the URL will look something like `&$filter=substringof('che',tolower(ProductName))"`.
64+
The server filtering requires binding to a web service, and it will result in GET requests where querystring parameters will denote the filtered field and operator. For example, if the `ProductName` field is set as the `DataValueField`, `Filter` is `contains` and the user input is `che`, the parameter added to the URL will look something like `&$filter=substringof('che',tolower(ProductName))"`.
65+
66+
With server filtering, RadMultiColumnComboBox will not request the data when initializing, only when the user types in a search string of sufficient length (see `MinLength`). This is done by setting the `autoBind` property of the underlying Kendo widget to `false`.
6267

6368
>caption Example 2: Enabling server filtering
6469
6570
````ASP.NET
6671
<telerik:RadMultiColumnComboBox runat="server" ID="RadMultiColumnComboBox1" Filter="Contains"
67-
DropDownWidth="600px" Height="400" EnableServerFiltering="true"
72+
EnableServerFiltering="true"
73+
DropDownWidth="600px" Height="400"
6874
DataTextField="ProductName" MinLength="3" Skin="Default" Width="100%"
6975
EnforceMinLength="false" DataValueField="ProductID"
7076
Placeholder="select from the dropdown or type">
@@ -79,7 +85,7 @@ The server filtering requires binding to a web service, and it will result in GE
7985
</telerik:RadMultiColumnComboBox>
8086
````
8187

82-
>caption Example 3: Server filtering through a RadClientDataSource requires setting its EnableServerFiltering property to true
88+
>caption Example 3: Server filtering through a RadClientDataSource requires setting its **EnableServerFiltering** property to **true**
8389
8490
````ASP.NET
8591
<telerik:RadMultiColumnComboBox runat="server" ID="RadMultiColumnComboBox1" Filter="Contains"

0 commit comments

Comments
 (0)