Skip to content

Commit 8fb354f

Browse files
docs(grid): clearer notes on data binding
1 parent a75b0f9 commit 8fb354f

File tree

1 file changed

+11
-2
lines changed

1 file changed

+11
-2
lines changed

components/grid/columns/bound.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@ Sections in this article:
1616

1717
* [Show Data In A Grid](#show-data-in-a-grid)
1818
* [Grid Bound Column Parameters](#grid-bound-column-parameters)
19+
* [Notes](#notes)
1920

2021

2122
## Show Data In A Grid
@@ -79,9 +80,17 @@ You can use the following properties on the bound columns:
7980
* `ref` - the standard Blazor reference name.
8081
* `EditorTemplate` - this property can also be used as an inner tag and it lets you define the [column edit content]({%slug components/grid/features/templates%}#edit-template). It can also point to a component name.
8182

82-
For an example of the column usage, see the [Grid Overview]({%slug components/grid/overview%}), the rest of the documentation and our [live demos](https://demos.telerik.com/blazor-ui/grid/overview).
83+
>tip For an example of the column usage, see the [Grid Overview](../overview) article, the rest of the documentation and our [live demos](https://demos.telerik.com/blazor-ui/grid/overview).
84+
85+
## Notes
86+
87+
88+
* For advanced operations such as grouping, filtering, sorting, you *must* set a `Field` to the column, and the field it points to must be a primitive type.
89+
* If a `Field` is not set the column will not allow filtering, grouping, sorting for the column.
90+
* If the `Field` points to a custom object or something like an `IDictionary`, errors will be thrown upon those actions because there are no known data operations on non-primitive types in .NET. An alternative is to implement all data source operations yourself by handling the [OnRead event](../manual-operations).
91+
* The grid skips fields marked with the [`IgnoreDataMemberAttribute`](https://docs.microsoft.com/en-us/dotnet/api/system.runtime.serialization.ignoredatamemberattribute) when performing CUD operations. Its presence indicates that this property does not need to be part of the serialized data anyway, and skipping such fields allows [Lazy Loading Proxies in EF](https://docs.microsoft.com/en-us/dotnet/api/microsoft.entityframeworkcore.proxiesextensions.uselazyloadingproxies?view=efcore-3.1) to work.
92+
* For the time being, nested models will not work (such as `Field="MyModel.AnotherModel.SomePrimitiveField"`). We are working on enabling this and you can follow its status [here](https://feedback.telerik.com/blazor/1432615-support-for-nested-complex-models).
8393

84-
>note For advanced operations such as grouping, filtering, sorting, you *must* set a `Field` to the column, and the field it points to must be a primitive type. If a `Field` is not set or it points to a custom object or something like an IDictionary, errors will be thrown because there are no known data operations on non-primitive types in .NET. An alternative is to implement all data source operations yourself by handling the [OnRead event](../manual-operations).
8594

8695
## See Also
8796

0 commit comments

Comments
 (0)