From 20203300263ddc0cdb667a8ba7078707b0ff42c9 Mon Sep 17 00:00:00 2001
From: Marin Bratanov <m.bratanov@gmail.com>
Date: Fri, 6 Nov 2020 17:04:51 +0200
Subject: [PATCH 01/22] chore(grid): better CRUD service mimic on editign
 overview page

---
 components/grid/editing/overview.md | 132 ++++++++++++++--------------
 1 file changed, 68 insertions(+), 64 deletions(-)

diff --git a/components/grid/editing/overview.md b/components/grid/editing/overview.md
index c675bacd41..c3030379a4 100644
--- a/components/grid/editing/overview.md
+++ b/components/grid/editing/overview.md
@@ -74,8 +74,6 @@ Editing is cancelled for the first two records.
 @code {
     async Task EditHandler(GridCommandEventArgs args)
     {
-        AppendToLog("Edit", args);
-
         SampleData item = (SampleData)args.Item;
 
         //prevent opening for edit based on condition
@@ -83,6 +81,8 @@ Editing is cancelled for the first two records.
         {
             args.IsCancelled = true;//the general approach for cancelling an event
         }
+
+        AppendToLog("Edit", args);
     }
 
     async Task UpdateHandler(GridCommandEventArgs args)
@@ -92,14 +92,10 @@ Editing is cancelled for the first two records.
         SampleData item = (SampleData)args.Item;
 
         // perform actual data source operations here through your service
-        SampleData updatedItem = await ServiceMimicUpdate(item);
-        
+        await MyService.Update(item);
+
         // update the local view-model data with the service data
-        var index = MyData.FindIndex(i => i.ID == updatedItem.ID);
-        if (index != -1)
-        {
-            MyData[index] = updatedItem;
-        }
+        await GetGridData();
     }
 
     async Task DeleteHandler(GridCommandEventArgs args)
@@ -109,13 +105,11 @@ Editing is cancelled for the first two records.
         SampleData item = (SampleData)args.Item;
 
         // perform actual data source operation here through your service
-        bool isDeleted = await ServiceMimicDelete(item);
-        
-        if (isDeleted)
-        {
-            // update the local view-model data
-            MyData.Remove(item);
-        }
+        await MyService.Delete(item);
+
+        // update the local view-model data with the service data
+        await GetGridData();
+
     }
 
     async Task CreateHandler(GridCommandEventArgs args)
@@ -125,10 +119,10 @@ Editing is cancelled for the first two records.
         SampleData item = (SampleData)args.Item;
 
         // perform actual data source operation here through your service
-        SampleData insertedItem = await ServiceMimicInsert(item);
-        
+        await MyService.Create(item);
+
         // update the local view-model data with the service data
-        MyData.Insert(0, insertedItem);
+        await GetGridData();
     }
 
     async Task CancelHandler(GridCommandEventArgs args)
@@ -142,44 +136,6 @@ Editing is cancelled for the first two records.
         await Task.Delay(1000); //simulate actual long running async operation
     }
 
-    // the following three methods mimic an actual data service that handles the actual data source
-    // you can see about implement error and exception handling, determining suitable return types as per your needs
-    // an example is available here: https://github.com/telerik/blazor-ui/tree/master/grid/remote-validation
-
-    async Task<SampleData> ServiceMimicInsert(SampleData itemToInsert)
-    {
-        await Task.Delay(2000); // simulate actual long running async operation
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently, we use "new" here
-        SampleData updatedItem = new SampleData()
-        {
-            // the service assigns an ID, in this sample we use only the view-model data for simplicity,
-            // you should use the actual data and set the properties as necessary (e.g., generate nested fields data and so on)
-            ID = MyData.Count + 1,
-            Name = itemToInsert.Name
-        };
-        return await Task.FromResult(updatedItem);
-    }
-
-    async Task<SampleData> ServiceMimicUpdate(SampleData itemToUpdate)
-    {
-        await Task.Delay(2000); // simulate actual long running async operation
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        SampleData updatedItem = new SampleData()
-        {
-            ID = itemToUpdate.ID,
-            Name = itemToUpdate.Name
-        };
-        return await Task.FromResult(updatedItem);
-    }
-
-    async Task<bool> ServiceMimicDelete(SampleData itemToDelete)
-    {
-        await Task.Delay(2000); // simulate actual long running async operation
-        return await Task.FromResult(true);//always successful
-    }
-
     // this method and field just display what happened for visual cues in this example
 
     MarkupString logger;
@@ -204,17 +160,65 @@ Editing is cancelled for the first two records.
 
     List<SampleData> MyData { get; set; }
 
-    protected override void OnInitialized()
+    async Task GetGridData()
+    {
+        MyData = await MyService.Read();
+    }
+
+    protected override async Task OnInitializedAsync()
+    {
+        await GetGridData();
+    }
+
+
+    // the following static class mimics an actual data service that handles the actual data source
+    // replace it with your actual service through the DI, this only mimics how the API will look like and works for this standalone page
+    public static class MyService
     {
-        MyData = new List<SampleData>();
+        private static List<SampleData> _data { get; set; } = new List<SampleData>();
 
-        for (int i = 0; i < 50; i++)
+        public static async Task Create(SampleData itemToInsert)
         {
-            MyData.Add(new SampleData()
+            await Task.Delay(1000); // simulate actual long running async operation
+
+            _data.Insert(0, itemToInsert);
+        }
+
+        public static async Task<List<SampleData>> Read()
+        {
+            await Task.Delay(1000); // simulate actual long running async operation
+
+            if (_data.Count < 1)
             {
-                ID = i,
-                Name = "Name " + i.ToString()
-            });
+                for (int i = 1; i < 50; i++)
+                {
+                    _data.Add(new SampleData()
+                    {
+                        ID = i,
+                        Name = "Name " + i.ToString()
+                    });
+                }
+            }
+
+            return await Task.FromResult(_data);
+        }
+
+        public static async Task Update(SampleData itemToUpdate)
+        {
+            await Task.Delay(1000); // simulate actual long running async operation
+
+            var index = _data.FindIndex(i => i.ID == itemToUpdate.ID);
+            if (index != -1)
+            {
+                _data[index] = itemToUpdate;
+            }
+        }
+
+        public static async Task Delete(SampleData itemToDelete)
+        {
+            await Task.Delay(1000); // simulate actual long running async operation
+
+            _data.Remove(itemToDelete);
         }
     }
 }

From b715484e462ae5dd8a6261cbf54830ab8a9f8b4e Mon Sep 17 00:00:00 2001
From: Marin Bratanov <m.bratanov@gmail.com>
Date: Sat, 7 Nov 2020 16:45:54 +0200
Subject: [PATCH 02/22] chore(grid): inline editing better crud mimic

---
 components/grid/editing/inline.md | 109 +++++++++++++++---------------
 1 file changed, 53 insertions(+), 56 deletions(-)

diff --git a/components/grid/editing/inline.md b/components/grid/editing/inline.md
index 1e92589bd0..0b21ecc9b2 100644
--- a/components/grid/editing/inline.md
+++ b/components/grid/editing/inline.md
@@ -62,14 +62,10 @@ Use the command buttons to control the CUD operations.
         SampleData item = (SampleData)args.Item;
 
         // perform actual data source operations here through your service
-        SampleData updatedItem = await ServiceMimicUpdate(item);
+        await MyService.Update(item);
 
-        // update the local view-model data
-        var index = MyData.FindIndex(i => i.ID == updatedItem.ID);
-        if (index != -1)
-        {
-            MyData[index] = updatedItem;
-        }
+        // update the local view-model data with the service data
+        await GetGridData();
 
         Console.WriteLine("Update event is fired.");
     }
@@ -79,13 +75,10 @@ Use the command buttons to control the CUD operations.
         SampleData item = (SampleData)args.Item;
 
         // perform actual data source operation here through your service
-        bool isDeleted = await ServiceMimicDelete(item);
+        await MyService.Delete(item);
 
-        if (isDeleted)
-        {
-            // update the local view-model data
-            MyData.Remove(item);
-        }
+        // update the local view-model data with the service data
+        await GetGridData();
 
         Console.WriteLine("Delete event is fired.");
     }
@@ -95,10 +88,10 @@ Use the command buttons to control the CUD operations.
         SampleData item = (SampleData)args.Item;
 
         // perform actual data source operation here through your service
-        SampleData insertedItem = await ServiceMimicInsert(item);
+        await MyService.Create(item);
 
-        // update the local view-model data
-        MyData.Insert(0, insertedItem);
+        // update the local view-model data with the service data
+        await GetGridData();
 
         Console.WriteLine("Create event is fired.");
     }
@@ -112,62 +105,66 @@ Use the command buttons to control the CUD operations.
         Console.WriteLine("Cancel event is fired.");
     }
 
-    // the following three methods mimic an actual data service that handles the actual data source
-    // you can see about implement error and exception handling, determining suitable return types as per your needs
-    // an example is available here: https://github.com/telerik/blazor-ui/tree/master/grid/remote-validation
 
-    async Task<SampleData> ServiceMimicInsert(SampleData itemToInsert)
+    // in a real case, keep the models in dedicated locations, this is just an easy to copy and see example
+    public class SampleData
     {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the inserted item differently
-        SampleData updatedItem = new SampleData()
-        {
-            // the service assigns an ID, in this sample we use only the view-model data for simplicity,
-            // you should use the actual data and set the properties as necessary (e.g., generate nested fields data and so on)
-            ID = MyData.Count + 1,
-            Name = itemToInsert.Name
-        };
-        return await Task.FromResult(updatedItem);
+        public int ID { get; set; }
+        public string Name { get; set; }
     }
 
-    async Task<SampleData> ServiceMimicUpdate(SampleData itemToUpdate)
+    public List<SampleData> MyData { get; set; }
+
+    async Task GetGridData()
     {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        SampleData updatedItem = new SampleData()
-        {
-            ID = itemToUpdate.ID,
-            Name = itemToUpdate.Name
-        };
-        return await Task.FromResult(updatedItem);
+        MyData = await MyService.Read();
     }
 
-    async Task<bool> ServiceMimicDelete(SampleData itemToDelete)
+    protected override async Task OnInitializedAsync()
     {
-        return await Task.FromResult(true);//always successful
+        await GetGridData();
     }
 
-
-    // in a real case, keep the models in dedicated locations, this is just an easy to copy and see example
-    public class SampleData
+    // the following static class mimics an actual data service that handles the actual data source
+    // replace it with your actual service through the DI, this only mimics how the API can look like and works for this standalone page
+    public static class MyService
     {
-        public int ID { get; set; }
-        public string Name { get; set; }
-    }
+        private static List<SampleData> _data { get; set; } = new List<SampleData>();
 
-    public List<SampleData> MyData { get; set; }
+        public static async Task Create(SampleData itemToInsert)
+        {
+            _data.Insert(0, itemToInsert);
+        }
 
-    protected override void OnInitialized()
-    {
-        MyData = new List<SampleData>();
+        public static async Task<List<SampleData>> Read()
+        {
+            if (_data.Count < 1)
+            {
+                for (int i = 1; i < 50; i++)
+                {
+                    _data.Add(new SampleData()
+                    {
+                        ID = i,
+                        Name = "Name " + i.ToString()
+                    });
+                }
+            }
+
+            return await Task.FromResult(_data);
+        }
 
-        for (int i = 1; i < 50; i++)
+        public static async Task Update(SampleData itemToUpdate)
         {
-            MyData.Add(new SampleData()
+            var index = _data.FindIndex(i => i.ID == itemToUpdate.ID);
+            if (index != -1)
             {
-                ID = i,
-                Name = "Name " + i.ToString()
-            });
+                _data[index] = itemToUpdate;
+            }
+        }
+
+        public static async Task Delete(SampleData itemToDelete)
+        {
+            _data.Remove(itemToDelete);
         }
     }
 }

From f0d76e5f6f0f730b7f2fce1c719dd867a05473f6 Mon Sep 17 00:00:00 2001
From: Marin Bratanov <m.bratanov@gmail.com>
Date: Sat, 7 Nov 2020 16:48:44 +0200
Subject: [PATCH 03/22] chore(grid): popup editing better crud mimic

---
 components/grid/editing/popup.md | 114 +++++++++++++++----------------
 1 file changed, 55 insertions(+), 59 deletions(-)

diff --git a/components/grid/editing/popup.md b/components/grid/editing/popup.md
index c06ffcc1cb..432482201e 100644
--- a/components/grid/editing/popup.md
+++ b/components/grid/editing/popup.md
@@ -65,14 +65,10 @@ The PopUp editing mode supports [validation]({%slug common-features/input-valida
         SampleData item = (SampleData)args.Item;
 
         // perform actual data source operations here through your service
-        SampleData updatedItem = await ServiceMimicUpdate(item);
+        await MyService.Update(item);
 
-        // update the local view-model data
-        var index = MyData.FindIndex(i => i.ID == updatedItem.ID);
-        if (index != -1)
-        {
-            MyData[index] = updatedItem;
-        }
+        // update the local view-model data with the service data
+        await GetGridData();
 
         Console.WriteLine("Update event is fired.");
     }
@@ -82,13 +78,10 @@ The PopUp editing mode supports [validation]({%slug common-features/input-valida
         SampleData item = (SampleData)args.Item;
 
         // perform actual data source operation here through your service
-        bool isDeleted = await ServiceMimicDelete(item);
+        await MyService.Delete(item);
 
-        if (isDeleted)
-        {
-            // update the local view-model data
-            MyData.Remove(item);
-        }
+        // update the local view-model data with the service data
+        await GetGridData();
 
         Console.WriteLine("Delete event is fired.");
     }
@@ -98,10 +91,10 @@ The PopUp editing mode supports [validation]({%slug common-features/input-valida
         SampleData item = (SampleData)args.Item;
 
         // perform actual data source operation here through your service
-        SampleData insertedItem = await ServiceMimicInsert(item);
+        await MyService.Create(item);
 
-        // update the local view-model data
-        MyData.Insert(0, insertedItem);
+        // update the local view-model data with the service data
+        await GetGridData();
 
         Console.WriteLine("Create event is fired.");
     }
@@ -115,42 +108,6 @@ The PopUp editing mode supports [validation]({%slug common-features/input-valida
         Console.WriteLine("Cancel event is fired.");
     }
 
-    // the following three methods mimic an actual data service that handles the actual data source
-    // you can see about implement error and exception handling, determining suitable return types as per your needs
-    // an example is available here: https://github.com/telerik/blazor-ui/tree/master/grid/remote-validation
-
-    async Task<SampleData> ServiceMimicInsert(SampleData itemToInsert)
-    {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the inserted item differently
-        SampleData updatedItem = new SampleData()
-        {
-            // the service assigns an ID, in this sample we use only the view-model data for simplicity,
-            // you should use the actual data and set the properties as necessary (e.g., generate nested fields data and so on)
-            ID = MyData.Count + 1,
-            Name = itemToInsert.Name
-        };
-        return await Task.FromResult(updatedItem);
-    }
-
-    async Task<SampleData> ServiceMimicUpdate(SampleData itemToUpdate)
-    {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        SampleData updatedItem = new SampleData()
-        {
-            ID = itemToUpdate.ID,
-            Name = itemToUpdate.Name
-        };
-        return await Task.FromResult(updatedItem);
-    }
-
-    async Task<bool> ServiceMimicDelete(SampleData itemToDelete)
-    {
-        return await Task.FromResult(true);//always successful
-    }
-
-
     // in a real case, keep the models in dedicated locations, this is just an easy to copy and see example
     public class SampleData
     {
@@ -162,17 +119,56 @@ The PopUp editing mode supports [validation]({%slug common-features/input-valida
 
     public List<SampleData> MyData { get; set; }
 
-    protected override void OnInitialized()
+    async Task GetGridData()
     {
-        MyData = new List<SampleData>();
+        MyData = await MyService.Read();
+    }
+
+    protected override async Task OnInitializedAsync()
+    {
+        await GetGridData();
+    }
+
+    // the following static class mimics an actual data service that handles the actual data source
+    // replace it with your actual service through the DI, this only mimics how the API can look like and works for this standalone page
+    public static class MyService
+    {
+        private static List<SampleData> _data { get; set; } = new List<SampleData>();
+
+        public static async Task Create(SampleData itemToInsert)
+        {
+            _data.Insert(0, itemToInsert);
+        }
+
+        public static async Task<List<SampleData>> Read()
+        {
+            if (_data.Count < 1)
+            {
+                for (int i = 1; i < 50; i++)
+                {
+                    _data.Add(new SampleData()
+                    {
+                        ID = i,
+                        Name = "Name " + i.ToString()
+                    });
+                }
+            }
+
+            return await Task.FromResult(_data);
+        }
 
-        for (int i = 1; i < 50; i++)
+        public static async Task Update(SampleData itemToUpdate)
         {
-            MyData.Add(new SampleData()
+            var index = _data.FindIndex(i => i.ID == itemToUpdate.ID);
+            if (index != -1)
             {
-                ID = i,
-                Name = "Name " + i.ToString()
-            });
+                _data[index] = itemToUpdate;
+            }
+        }
+
+        public static async Task Delete(SampleData itemToDelete)
+        {
+            _data.Remove(itemToDelete);
         }
     }
 }

From 093c9219a2cb5c50c36b49707d3d89e7a65d95a1 Mon Sep 17 00:00:00 2001
From: Marin Bratanov <m.bratanov@gmail.com>
Date: Sat, 7 Nov 2020 16:53:59 +0200
Subject: [PATCH 04/22] chore(grid): incell editing better crud mimic

---
 components/grid/editing/incell.md | 110 ++++++++++++++----------------
 1 file changed, 53 insertions(+), 57 deletions(-)

diff --git a/components/grid/editing/incell.md b/components/grid/editing/incell.md
index b40f5a1185..b48a3a4bc7 100644
--- a/components/grid/editing/incell.md
+++ b/components/grid/editing/incell.md
@@ -66,14 +66,10 @@ Click a cell, edit it and click outside of the cell to see the change.
         SampleData item = (SampleData)args.Item;
 
         // perform actual data source operations here through your service
-        SampleData updatedItem = await ServiceMimicUpdate(item);
+        await MyService.Update(item);
 
-        // update the local view-model data
-        var index = MyData.FindIndex(i => i.ID == updatedItem.ID);
-        if (index != -1)
-        {
-            MyData[index] = updatedItem;
-        }
+        // update the local view-model data with the service data
+        await GetGridData();
 
         Console.WriteLine("Update event is fired.");
     }
@@ -83,13 +79,10 @@ Click a cell, edit it and click outside of the cell to see the change.
         SampleData item = (SampleData)args.Item;
 
         // perform actual data source operation here through your service
-        bool isDeleted = await ServiceMimicDelete(item);
+        await MyService.Delete(item);
 
-        if (isDeleted)
-        {
-            // update the local view-model data
-            MyData.Remove(item);
-        }
+        // update the local view-model data with the service data
+        await GetGridData();
 
         Console.WriteLine("Delete event is fired.");
     }
@@ -99,71 +92,74 @@ Click a cell, edit it and click outside of the cell to see the change.
         SampleData item = (SampleData)args.Item;
 
         // perform actual data source operation here through your service
-        SampleData insertedItem = await ServiceMimicInsert(item);
+        await MyService.Create(item);
 
-        // update the local view-model data
-        MyData.Insert(0, insertedItem);
+        // update the local view-model data with the service data
+        await GetGridData();
 
         Console.WriteLine("Create event is fired.");
     }
 
 
-    // the following three methods mimic an actual data service that handles the actual data source
-    // you can see about implement error and exception handling, determining suitable return types as per your needs
-    // an example is available here: https://github.com/telerik/blazor-ui/tree/master/grid/remote-validation
-
-    async Task<SampleData> ServiceMimicInsert(SampleData itemToInsert)
+    // in a real case, keep the models in dedicated locations, this is just an easy to copy and see example
+    public class SampleData
     {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        SampleData updatedItem = new SampleData()
-        {
-            // the service assigns an ID, in this sample we use only the view-model data for simplicity,
-            // you should use the actual data and set the properties as necessary (e.g., generate nested fields data and so on)
-            ID = MyData.Count + 1,
-            Name = itemToInsert.Name
-        };
-        return await Task.FromResult(updatedItem);
+        public int ID { get; set; }
+        public string Name { get; set; }
     }
 
-    async Task<SampleData> ServiceMimicUpdate(SampleData itemToUpdate)
+    public List<SampleData> MyData { get; set; }
+
+    async Task GetGridData()
     {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        SampleData updatedItem = new SampleData()
-        {
-            ID = itemToUpdate.ID,
-            Name = itemToUpdate.Name
-        };
-        return await Task.FromResult(updatedItem);
+        MyData = await MyService.Read();
     }
 
-    async Task<bool> ServiceMimicDelete(SampleData itemToDelete)
+    protected override async Task OnInitializedAsync()
     {
-        return await Task.FromResult(true);//always successful
+        await GetGridData();
     }
 
-
-    // in a real case, keep the models in dedicated locations, this is just an easy to copy and see example
-    public class SampleData
+    // the following static class mimics an actual data service that handles the actual data source
+    // replace it with your actual service through the DI, this only mimics how the API can look like and works for this standalone page
+    public static class MyService
     {
-        public int ID { get; set; }
-        public string Name { get; set; }
-    }
+        private static List<SampleData> _data { get; set; } = new List<SampleData>();
 
-    public List<SampleData> MyData { get; set; }
+        public static async Task Create(SampleData itemToInsert)
+        {
+            _data.Insert(0, itemToInsert);
+        }
 
-    protected override void OnInitialized()
-    {
-        MyData = new List<SampleData>();
+        public static async Task<List<SampleData>> Read()
+        {
+            if (_data.Count < 1)
+            {
+                for (int i = 1; i < 50; i++)
+                {
+                    _data.Add(new SampleData()
+                    {
+                        ID = i,
+                        Name = "Name " + i.ToString()
+                    });
+                }
+            }
+
+            return await Task.FromResult(_data);
+        }
 
-        for (int i = 1; i < 50; i++)
+        public static async Task Update(SampleData itemToUpdate)
         {
-            MyData.Add(new SampleData()
+            var index = _data.FindIndex(i => i.ID == itemToUpdate.ID);
+            if (index != -1)
             {
-                ID = i,
-                Name = "Name " + i.ToString()
-            });
+                _data[index] = itemToUpdate;
+            }
+        }
+
+        public static async Task Delete(SampleData itemToDelete)
+        {
+            _data.Remove(itemToDelete);
         }
     }
 }

From 8021b688adaecf173bf4f8d0d6637f12bd761a38 Mon Sep 17 00:00:00 2001
From: Marin Bratanov <m.bratanov@gmail.com>
Date: Sat, 7 Nov 2020 17:02:12 +0200
Subject: [PATCH 05/22] chore(grid): autogetn columns editing better crud mimic

---
 components/grid/columns/auto-generated.md | 170 ++++++++++------------
 1 file changed, 76 insertions(+), 94 deletions(-)

diff --git a/components/grid/columns/auto-generated.md b/components/grid/columns/auto-generated.md
index 3f4be1449e..5231922f1f 100644
--- a/components/grid/columns/auto-generated.md
+++ b/components/grid/columns/auto-generated.md
@@ -199,33 +199,30 @@ This example shows how to:
 @using System.Collections.ObjectModel
 
 <div style="max-width: 800px;">
-    <EditForm Model="@DataModel">
-        <DataAnnotationsValidator />
-        <ValidationSummary />
-        <TelerikGrid Data="@GridData"
-                     AutoGenerateColumns="true"
-                     EditMode="GridEditMode.Popup"
-                     Pageable="true"
-                     SelectionMode="GridSelectionMode.Multiple"
-                     @bind-SelectedItems="@SelectedUsers"
-                     PageSize="@PageSize"
-                     OnCreate="@CreateItem"
-                     OnUpdate="@UpdateItem"
-                     OnDelete="@DeleteItem">
-            <GridToolBar>
-                <GridCommandButton Command="Add" Icon="add">Add</GridCommandButton>
-            </GridToolBar>
-            <GridColumns>
-                <GridCheckboxColumn />
-                <GridAutoGeneratedColumns ColumnWidth="200px" />
-                <GridColumn Field="@nameof(GridDataModel.RegistrationDate)" Title="Registration Date" Width="200px" />
-                <GridCommandColumn Width="250px">
-                    <GridCommandButton Command="Edit" Icon="edit">Edit</GridCommandButton>
-                    <GridCommandButton Command="Delete" Icon="delete">Delete</GridCommandButton>
-                </GridCommandColumn>
-            </GridColumns>
-        </TelerikGrid>
-    </EditForm>
+    
+    <TelerikGrid Data="@GridData"
+                    AutoGenerateColumns="true"
+                    EditMode="GridEditMode.Popup"
+                    Pageable="true"
+                    SelectionMode="GridSelectionMode.Multiple"
+                    @bind-SelectedItems="@SelectedUsers"
+                    PageSize="@PageSize"
+                    OnCreate="@CreateItem"
+                    OnUpdate="@UpdateItem"
+                    OnDelete="@DeleteItem">
+        <GridToolBar>
+            <GridCommandButton Command="Add" Icon="add">Add</GridCommandButton>
+        </GridToolBar>
+        <GridColumns>
+            <GridCheckboxColumn />
+            <GridAutoGeneratedColumns ColumnWidth="200px" />
+            <GridColumn Field="@nameof(GridDataModel.RegistrationDate)" Title="Registration Date" Width="200px" />
+            <GridCommandColumn Width="250px">
+                <GridCommandButton Command="Edit" Icon="edit">Edit</GridCommandButton>
+                <GridCommandButton Command="Delete" Icon="delete">Delete</GridCommandButton>
+            </GridCommandColumn>
+        </GridColumns>
+    </TelerikGrid>
 
 
     @if (SelectedUsers.Any())
@@ -253,7 +250,6 @@ This example shows how to:
     public List<GridDataModel> GridData { get; set; }
     public IEnumerable<GridDataModel> SelectedUsers { get; set; } = new ObservableCollection<GridDataModel>();
     public int PageSize { get; set; } = 3;
-    GridDataModel DataModel = new GridDataModel();
 
     #region data model with annotations
     public class GridDataModel
@@ -290,14 +286,10 @@ This example shows how to:
         GridDataModel item = (GridDataModel)args.Item;
 
         // perform actual data source operations here through your service
-        GridDataModel updatedItem = await ServiceMimicUpdate(item);
+        await MyService.Update(item);
 
-        // update the local view-model data
-        var index = GridData.FindIndex(i => i.Id == updatedItem.Id);
-        if (index != -1)
-        {
-            GridData[index] = updatedItem;
-        }
+        // update the local view-model data with the service data
+        await GetGridData();
     }
 
     async Task DeleteItem(GridCommandEventArgs args)
@@ -305,13 +297,10 @@ This example shows how to:
         GridDataModel item = (GridDataModel)args.Item;
 
         // perform actual data source operation here through your service
-        bool isDeleted = await ServiceMimicDelete(item);
+        await MyService.Delete(item);
 
-        if (isDeleted)
-        {
-            // update the local view-model data
-            GridData.Remove(item);
-        }
+        // update the local view-model data with the service data
+        await GetGridData();
     }
 
     async Task CreateItem(GridCommandEventArgs args)
@@ -319,77 +308,70 @@ This example shows how to:
         GridDataModel item = (GridDataModel)args.Item;
 
         // perform actual data source operation here through your service
-        GridDataModel insertedItem = await ServiceMimicInsert(item);
+        await MyService.Create(item);
 
-        // update the local view-model data
-        GridData.Insert(0, insertedItem);
+        // update the local view-model data with the service data
+        await GetGridData();
     }
 
+    #endregion
 
-    // the following three methods mimic an actual data service that handles the actual data source
-    // you can see about implement error and exception handling, determining suitable return types as per your needs
-    // an example is available here: https://github.com/telerik/blazor-ui/tree/master/grid/remote-validation
-
-    async Task<GridDataModel> ServiceMimicInsert(GridDataModel itemToInsert)
+    async Task GetGridData()
     {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        GridDataModel updatedItem = new GridDataModel()
-        {
-            // the service assigns an ID, in this sample we use only the view-model data for simplicity,
-            // you should use the actual data and set the properties as necessary (e.g., generate nested fields data and so on)
-            Id = GridData.Count + 1,
-            Username = itemToInsert.Username,
-            EmailAddress = itemToInsert.EmailAddress,
-            RegistrationDate = itemToInsert.RegistrationDate,
-            LocalTime = itemToInsert.LocalTime,
-            BoughtBooks = itemToInsert.BoughtBooks
-        };
-        return await Task.FromResult(updatedItem);
+        GridData = await MyService.Read();
     }
 
-    async Task<GridDataModel> ServiceMimicUpdate(GridDataModel itemToUpdate)
+    protected override async Task OnInitializedAsync()
     {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        GridDataModel updatedItem = new GridDataModel()
-        {
-            Id = itemToUpdate.Id,
-            Username = itemToUpdate.Username,
-            EmailAddress = itemToUpdate.EmailAddress,
-            RegistrationDate = itemToUpdate.RegistrationDate,
-            LocalTime = itemToUpdate.LocalTime,
-            BoughtBooks = itemToUpdate.BoughtBooks
-        };
-        return await Task.FromResult(updatedItem);
+        await GetGridData();
     }
 
-    async Task<bool> ServiceMimicDelete(GridDataModel itemToDelete)
+    // the following static class mimics an actual data service that handles the actual data source
+    // replace it with your actual service through the DI, this only mimics how the API can look like and works for this standalone page
+    public static class MyService
     {
-        return await Task.FromResult(true);//always successful
-    }
+        private static List<GridDataModel> _data { get; set; } = new List<GridDataModel>();
 
-    #endregion
+        public static async Task Create(GridDataModel itemToInsert)
+        {
+            itemToInsert.Id = _data.Count + 1;
+            _data.Insert(0, itemToInsert);
+        }
 
-    #region data generation
-    protected override void OnInitialized()
-    {
-        GridData = new List<GridDataModel>();
-        for (int i = 0; i < 45; i++)
+        public static async Task<List<GridDataModel>> Read()
+        {
+            if (_data.Count < 1)
+            {
+                for (int i = 0; i < 45; i++)
+                {
+                    _data.Add(new GridDataModel()
+                    {
+                        Id = i,
+                        Username = $"Username {i}",
+                        EmailAddress = $"user{i}@mail.com",
+                        RegistrationDate = DateTime.Now.AddDays(-2),
+                        LocalTime = DateTime.Now
+                    });
+                }
+            }
+
+            return await Task.FromResult(_data);
+        }
+
+        public static async Task Update(GridDataModel itemToUpdate)
         {
-            GridData.Add(new GridDataModel()
+            var index = _data.FindIndex(i => i.Id == itemToUpdate.Id);
+            if (index != -1)
             {
-                Id = i,
-                Username = $"Username {i}",
-                EmailAddress = $"user{i}@mail.com",
-                RegistrationDate = DateTime.Now.AddDays(-2),
-                LocalTime = DateTime.Now
-            });
+                _data[index] = itemToUpdate;
+            }
         }
 
-        base.OnInitialized();
+        public static async Task Delete(GridDataModel itemToDelete)
+        {
+            _data.Remove(itemToDelete);
+        }
     }
-    #endregion
 }
 ````
 >caption The result from the code snippet above

From e4aa22fa18c28ef4c351ab35a4dfd7ebcac45755 Mon Sep 17 00:00:00 2001
From: Marin Bratanov <m.bratanov@gmail.com>
Date: Sat, 7 Nov 2020 17:03:54 +0200
Subject: [PATCH 06/22] chore(grid): insertion to generate ID

---
 components/grid/editing/incell.md   | 1 +
 components/grid/editing/inline.md   | 1 +
 components/grid/editing/overview.md | 1 +
 components/grid/editing/popup.md    | 1 +
 4 files changed, 4 insertions(+)

diff --git a/components/grid/editing/incell.md b/components/grid/editing/incell.md
index b48a3a4bc7..7e5bbc8cc8 100644
--- a/components/grid/editing/incell.md
+++ b/components/grid/editing/incell.md
@@ -128,6 +128,7 @@ Click a cell, edit it and click outside of the cell to see the change.
 
         public static async Task Create(SampleData itemToInsert)
         {
+            itemToInsert.Id = _data.Count + 1;
             _data.Insert(0, itemToInsert);
         }
 
diff --git a/components/grid/editing/inline.md b/components/grid/editing/inline.md
index 0b21ecc9b2..a1d46244a1 100644
--- a/components/grid/editing/inline.md
+++ b/components/grid/editing/inline.md
@@ -133,6 +133,7 @@ Use the command buttons to control the CUD operations.
 
         public static async Task Create(SampleData itemToInsert)
         {
+            itemToInsert.Id = _data.Count + 1;
             _data.Insert(0, itemToInsert);
         }
 
diff --git a/components/grid/editing/overview.md b/components/grid/editing/overview.md
index c3030379a4..b9b9ea37da 100644
--- a/components/grid/editing/overview.md
+++ b/components/grid/editing/overview.md
@@ -181,6 +181,7 @@ Editing is cancelled for the first two records.
         {
             await Task.Delay(1000); // simulate actual long running async operation
 
+            itemToInsert.Id = _data.Count + 1;
             _data.Insert(0, itemToInsert);
         }
 
diff --git a/components/grid/editing/popup.md b/components/grid/editing/popup.md
index 432482201e..3a7a068eeb 100644
--- a/components/grid/editing/popup.md
+++ b/components/grid/editing/popup.md
@@ -137,6 +137,7 @@ The PopUp editing mode supports [validation]({%slug common-features/input-valida
 
         public static async Task Create(SampleData itemToInsert)
         {
+            itemToInsert.Id = _data.Count + 1;
             _data.Insert(0, itemToInsert);
         }
 

From b8975cbf469e666515aea63259a77d320790979d Mon Sep 17 00:00:00 2001
From: Marin Bratanov <m.bratanov@gmail.com>
Date: Sat, 7 Nov 2020 17:08:19 +0200
Subject: [PATCH 07/22] chore(grid): command column editing better crud mimic

---
 components/grid/columns/command.md | 72 +++++++++++++++++++-----------
 1 file changed, 46 insertions(+), 26 deletions(-)

diff --git a/components/grid/columns/command.md b/components/grid/columns/command.md
index f1504318ae..77540934b8 100644
--- a/components/grid/columns/command.md
+++ b/components/grid/columns/command.md
@@ -99,12 +99,7 @@ The following code example demonstrates declarations and handling.
         public DateTime HireDate { get; set; }
     }
 
-    List<SampleData> GridData = Enumerable.Range(1, 50).Select(x => new SampleData
-    {
-        ID = x,
-        Name = "name " + x,
-        HireDate = DateTime.Now.AddDays(-x)
-    }).ToList();
+    List<SampleData> GridData { get; set; }
 
     // sample custom commands handling
 
@@ -129,36 +124,61 @@ The following code example demonstrates declarations and handling.
 
     }
 
-    // sample CUD operations
+    // sample CRUD operations
 
     private async Task MyUpdateHandler(GridCommandEventArgs args)
     {
         SampleData theUpdatedItem = args.Item as SampleData;
-        SampleData updatedItem = await ServiceMimicUpdate(theUpdatedItem);
 
-        // update the local view-model data
-        var index = GridData.FindIndex(i => i.ID == updatedItem.ID);
-        if (index != -1)
-        {
-            GridData[index] = updatedItem;
-        }
+        // perform actual data source operations here through your service
+        await MyService.Update(theUpdatedItem);
+
+        // update the local view-model data with the service data
+        await GetGridData();
+    }
+
+    async Task GetGridData()
+    {
+        GridData = await MyService.Read();
     }
 
-    // the following method mimics an actual data service that handles the actual data source
-    // you can see about implement error and exception handling, determining suitable return types as per your needs
-    // an example is available here: https://github.com/telerik/blazor-ui/tree/master/grid/remote-validation
+    protected override async Task OnInitializedAsync()
+    {
+        await GetGridData();
+    }
 
-    async Task<SampleData> ServiceMimicUpdate(SampleData itemToUpdate)
+    // the following static class mimics an actual data service that handles the actual data source
+    // replace it with your actual service through the DI, this only mimics how the API can look like and works for this standalone page
+    public static class MyService
     {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        SampleData updatedItem = new SampleData()
+        private static List<SampleData> _data { get; set; } = new List<SampleData>();
+
+        public static async Task<List<SampleData>> Read()
         {
-            ID = itemToUpdate.ID,
-            HireDate = itemToUpdate.HireDate,
-            Name = itemToUpdate.Name
-        };
-        return await Task.FromResult(updatedItem);
+            if (_data.Count < 1)
+            {
+                for (int i = 1; i < 50; i++)
+                {
+                    _data.Add(new SampleData()
+                    {
+                        ID = i,
+                        Name = "name " + i,
+                        HireDate = DateTime.Now.AddDays(-i)
+                    });
+                }
+            }
+
+            return await Task.FromResult(_data);
+        }
+
+        public static async Task Update(SampleData itemToUpdate)
+        {
+            var index = _data.FindIndex(i => i.ID == itemToUpdate.ID);
+            if (index != -1)
+            {
+                _data[index] = itemToUpdate;
+            }
+        }
     }
 }
 ````

From a47dc45a193b2176a65186cb8107a46f920e5766 Mon Sep 17 00:00:00 2001
From: Marin Bratanov <m.bratanov@gmail.com>
Date: Sat, 7 Nov 2020 17:17:14 +0200
Subject: [PATCH 08/22] chore(grid): state dics editing better crud mimic

---
 components/grid/state.md | 259 ++++++++++++++++++++-------------------
 1 file changed, 132 insertions(+), 127 deletions(-)

diff --git a/components/grid/state.md b/components/grid/state.md
index d33937b072..2f98e5f411 100644
--- a/components/grid/state.md
+++ b/components/grid/state.md
@@ -119,7 +119,6 @@ The following example shows one way you can store the grid state - through a cus
 ````Component
 @inject LocalStorage LocalStorage
 @inject IJSRuntime JsInterop
-
 Change something in the grid (like sort, filter, select, page, resize columns, etc.), then reload the page to see the grid state fetched from the browser local storage.
 <br />
 
@@ -169,6 +168,9 @@ Change something in the grid (like sort, filter, select, page, resize columns, e
     // Load and Save the state through the grid events
 
     string UniqueStorageKey = "SampleGridStateStorageThatShouldBeUnique";
+    TelerikGrid<SampleData> Grid { get; set; }
+    IEnumerable<SampleData> SelectedItems { get; set; } = Enumerable.Empty<SampleData>();
+    List<SampleData> GridData { get; set; }
 
     async Task OnStateInitHandler(GridStateEventArgs<SampleData> args)
     {
@@ -193,7 +195,6 @@ Change something in the grid (like sort, filter, select, page, resize columns, e
         await LocalStorage.SetItem(UniqueStorageKey, args.GridState);
     }
 
-    TelerikGrid<SampleData> Grid { get; set; }
     async Task ResetState()
     {
         // clean up the storage
@@ -214,14 +215,12 @@ Change something in the grid (like sort, filter, select, page, resize columns, e
         SampleData item = (SampleData)args.Item;
 
         // perform actual data source operations here through your service
-        SampleData updatedItem = await ServiceMimicUpdate(item);
+        await MyService.Update(item);
 
-        // update the local view-model data
-        var index = GridData.FindIndex(i => i.Id == updatedItem.Id);
-        if (index != -1)
-        {
-            GridData[index] = updatedItem;
-        }
+        // update the local view-model data with the service data
+        await GetGridData();
+
+        Console.WriteLine("Update event is fired.");
     }
 
     async Task DeleteItem(GridCommandEventArgs args)
@@ -229,13 +228,12 @@ Change something in the grid (like sort, filter, select, page, resize columns, e
         SampleData item = (SampleData)args.Item;
 
         // perform actual data source operation here through your service
-        bool isDeleted = await ServiceMimicDelete(item);
+        await MyService.Delete(item);
 
-        if (isDeleted)
-        {
-            // update the local view-model data
-            GridData.Remove(item);
-        }
+        // update the local view-model data with the service data
+        await GetGridData();
+
+        Console.WriteLine("Delete event is fired.");
     }
 
     async Task CreateItem(GridCommandEventArgs args)
@@ -243,79 +241,89 @@ Change something in the grid (like sort, filter, select, page, resize columns, e
         SampleData item = (SampleData)args.Item;
 
         // perform actual data source operation here through your service
-        SampleData insertedItem = await ServiceMimicInsert(item);
+        await MyService.Create(item);
 
-        // update the local view-model data
-        GridData.Insert(0, insertedItem);
-    }
+        // update the local view-model data with the service data
+        await GetGridData();
 
+        Console.WriteLine("Create event is fired.");
+    }
 
-    // the following three methods mimic an actual data service that handles the actual data source
-    // you can see about implement error and exception handling, determining suitable return types as per your needs
-    // an example is available here: https://github.com/telerik/blazor-ui/tree/master/grid/remote-validation
+    // Note the Equals override for restoring selection and editing
 
-    async Task<SampleData> ServiceMimicInsert(SampleData itemToInsert)
+    public class SampleData
     {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        SampleData updatedItem = new SampleData()
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public string Team { get; set; }
+
+        // example of comparing stored items (from editing or selection)
+        // with items from the current data source - IDs are used instead of the default references
+        public override bool Equals(object obj)
         {
-            // the service assigns an ID, in this sample we use only the view-model data for simplicity,
-            // you should use the actual data and set the properties as necessary (e.g., generate nested fields data and so on)
-            Id = GridData.Count + 1,
-            Name = itemToInsert.Name,
-            Team = itemToInsert.Team
-        };
-        return await Task.FromResult(updatedItem);
+            if (obj is SampleData)
+            {
+                return this.Id == (obj as SampleData).Id;
+            }
+            return false;
+        }
     }
 
-    async Task<SampleData> ServiceMimicUpdate(SampleData itemToUpdate)
+    async Task GetGridData()
     {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        SampleData updatedItem = new SampleData()
-        {
-            Id = itemToUpdate.Id,
-            Name = itemToUpdate.Name,
-            Team = itemToUpdate.Team
-        };
-        return await Task.FromResult(updatedItem);
+        GridData = await MyService.Read();
     }
 
-    async Task<bool> ServiceMimicDelete(SampleData itemToDelete)
+    protected override async Task OnInitializedAsync()
     {
-        return await Task.FromResult(true);//always successful
+        await GetGridData();
     }
 
-    // Sample data follows below
+    // the following static class mimics an actual data service that handles the actual data source
+    // replace it with your actual service through the DI, this only mimics how the API can look like and works for this standalone page
+    public static class MyService
+    {
+        private static List<SampleData> _data { get; set; } = new List<SampleData>();
 
-    public IEnumerable<SampleData> SelectedItems { get; set; } = Enumerable.Empty<SampleData>();
+        public static async Task Create(SampleData itemToInsert)
+        {
+            itemToInsert.Id = _data.Count + 1;
+            _data.Insert(0, itemToInsert);
+        }
 
-    public List<SampleData> GridData { get; set; } = Enumerable.Range(1, 30).Select(x => new SampleData
-    {
-        Id = x,
-        Name = "name " + x,
-        Team = "team " + x % 5
-    }).ToList();
+        public static async Task<List<SampleData>> Read()
+        {
+            if (_data.Count < 1)
+            {
+                for (int i = 1; i < 50; i++)
+                {
+                    _data.Add(new SampleData()
+                    {
+                        Id = i,
+                        Name = "name " + i,
+                        Team = "team " + i % 5
+                    });
+                }
+            }
 
-    public class SampleData
-    {
-        public int Id { get; set; }
-        public string Name { get; set; }
-        public string Team { get; set; }
+            return await Task.FromResult(_data);
+        }
 
-        // example of comparing stored items (from editing or selection)
-        // with items from the current data source - IDs are used instead of the default references
-        public override bool Equals(object obj)
+        public static async Task Update(SampleData itemToUpdate)
         {
-            if (obj is SampleData)
+            var index = _data.FindIndex(i => i.Id == itemToUpdate.Id);
+            if (index != -1)
             {
-                return this.Id == (obj as SampleData).Id;
+                _data[index] = itemToUpdate;
             }
-            return false;
+        }
+
+        public static async Task Delete(SampleData itemToDelete)
+        {
+            _data.Remove(itemToDelete);
         }
     }
-}
+}****
 ````
 ````Service
 using Microsoft.JSInterop;
@@ -532,7 +540,7 @@ In addition to that, you can also use the `EditItem`, `OriginalEditItem` and `In
 ````CSHTML
 @* This example shows how to make the grid edit a certain item or start insert operation
     through your own code, without requiring the user to click the Command buttons.
-    The buttons that initiate these operations can be anywhere on the page, inlcuding inside the grid.
+    The buttons that initiate these operations can be anywhere on the page, including inside the grid.
     Note the model constructors and static method that show how to get a new instance for the edit item
 *@
 
@@ -567,8 +575,8 @@ In addition to that, you can also use the `EditItem`, `OriginalEditItem` and `In
         // you can predefine values here as well (not mandatory)
         currState.InsertedItem = new SampleData() { Name = "some predefined value" };
         await GridRef.SetState(currState);
-        
-         // note: possible only for Inline and Popup edit modes, with InCell there is never an inserted item, only edited items
+
+        // note: possible only for Inline and Popup edit modes, with InCell there is never an inserted item, only edited items
     }
 
     async Task EditItemFour()
@@ -594,14 +602,10 @@ In addition to that, you can also use the `EditItem`, `OriginalEditItem` and `In
         SampleData item = (SampleData)args.Item;
 
         // perform actual data source operations here through your service
-        SampleData updatedItem = await ServiceMimicUpdate(item);
+        await MyService.Update(item);
 
-        // update the local view-model data
-        var index = MyData.FindIndex(i => i.ID == updatedItem.ID);
-        if (index != -1)
-        {
-            MyData[index] = updatedItem;
-        }
+        // update the local view-model data with the service data
+        await GetGridData();
     }
 
     async Task DeleteHandler(GridCommandEventArgs args)
@@ -609,13 +613,10 @@ In addition to that, you can also use the `EditItem`, `OriginalEditItem` and `In
         SampleData item = (SampleData)args.Item;
 
         // perform actual data source operation here through your service
-        bool isDeleted = await ServiceMimicDelete(item);
+        await MyService.Delete(item);
 
-        if (isDeleted)
-        {
-            // update the local view-model data
-            MyData.Remove(item);
-        }
+        // update the local view-model data with the service data
+        await GetGridData();
     }
 
     async Task CreateHandler(GridCommandEventArgs args)
@@ -623,46 +624,10 @@ In addition to that, you can also use the `EditItem`, `OriginalEditItem` and `In
         SampleData item = (SampleData)args.Item;
 
         // perform actual data source operation here through your service
-        SampleData insertedItem = await ServiceMimicInsert(item);
+        await MyService.Create(item);
 
-        // update the local view-model data
-        MyData.Insert(0, insertedItem);
-    }
-
-
-    // the following three methods mimic an actual data service that handles the actual data source
-    // you can see about implement error and exception handling, determining suitable return types as per your needs
-    // an example is available here: https://github.com/telerik/blazor-ui/tree/master/grid/remote-validation
-
-    async Task<SampleData> ServiceMimicInsert(SampleData itemToInsert)
-    {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        SampleData updatedItem = new SampleData()
-        {
-            // the service assigns an ID, in this sample we use only the view-model data for simplicity,
-            // you should use the actual data and set the properties as necessary (e.g., generate nested fields data and so on)
-            ID = MyData.Count + 1,
-            Name = itemToInsert.Name
-        };
-        return await Task.FromResult(updatedItem);
-    }
-
-    async Task<SampleData> ServiceMimicUpdate(SampleData itemToUpdate)
-    {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        SampleData updatedItem = new SampleData()
-        {
-            ID = itemToUpdate.ID,
-            Name = itemToUpdate.Name
-        };
-        return await Task.FromResult(updatedItem);
-    }
-
-    async Task<bool> ServiceMimicDelete(SampleData itemToDelete)
-    {
-        return await Task.FromResult(true);//always successful
+        // update the local view-model data with the service data
+        await GetGridData();
     }
 
     // Sample class definition - note the constructors, overrides and comments
@@ -708,17 +673,57 @@ In addition to that, you can also use the `EditItem`, `OriginalEditItem` and `In
 
     public List<SampleData> MyData { get; set; }
 
-    protected override void OnInitialized()
+    async Task GetGridData()
+    {
+        MyData = await MyService.Read();
+    }
+
+    protected override async Task OnInitializedAsync()
+    {
+        await GetGridData();
+    }
+
+    // the following static class mimics an actual data service that handles the actual data source
+    // replace it with your actual service through the DI, this only mimics how the API can look like and works for this standalone page
+    public static class MyService
     {
-        MyData = new List<SampleData>();
+        private static List<SampleData> _data { get; set; } = new List<SampleData>();
+
+        public static async Task Create(SampleData itemToInsert)
+        {
+            itemToInsert.ID = _data.Count + 1;
+            _data.Insert(0, itemToInsert);
+        }
 
-        for (int i = 0; i < 50; i++)
+        public static async Task<List<SampleData>> Read()
         {
-            MyData.Add(new SampleData()
+            if (_data.Count < 1)
             {
-                ID = i,
-                Name = "Name " + i.ToString()
-            });
+                for (int i = 1; i < 50; i++)
+                {
+                    _data.Add(new SampleData()
+                    {
+                        ID = i,
+                        Name = "Name " + i.ToString()
+                    });
+                }
+            }
+
+            return await Task.FromResult(_data);
+        }
+
+        public static async Task Update(SampleData itemToUpdate)
+        {
+            var index = _data.FindIndex(i => i.ID == itemToUpdate.ID);
+            if (index != -1)
+            {
+                _data[index] = itemToUpdate;
+            }
+        }
+
+        public static async Task Delete(SampleData itemToDelete)
+        {
+            _data.Remove(itemToDelete);
         }
     }
 }

From 23e056f6379249aee42cb0390e0bc7fc0f56b061 Mon Sep 17 00:00:00 2001
From: Marin Bratanov <m.bratanov@gmail.com>
Date: Sat, 7 Nov 2020 17:37:32 +0200
Subject: [PATCH 09/22] chore(grid): editor template better crud mimic

---
 components/grid/templates/editor.md | 206 +++++++++++++++-------------
 1 file changed, 111 insertions(+), 95 deletions(-)

diff --git a/components/grid/templates/editor.md b/components/grid/templates/editor.md
index 8f2f42d283..101aba643e 100644
--- a/components/grid/templates/editor.md
+++ b/components/grid/templates/editor.md
@@ -54,66 +54,79 @@ You can find the following examples below:
 </TelerikGrid>
 
 @code {
-    public SampleData CurrentlyEditedEmployee { get; set; }
+    List<SampleData> MyData { get; set; }
+    List<string> Roles { get; set; }
+    SampleData CurrentlyEditedEmployee { get; set; }
 
     public async Task UpdateHandler(GridCommandEventArgs args)
     {
         SampleData item = (SampleData)args.Item;
 
         // perform actual data source operations here through your service
-        SampleData updatedItem = await ServiceMimicUpdate(item);
+        await MyService.Update(item);
 
-        // update the local view-model data
-        var index = MyData.FindIndex(i => i.ID == updatedItem.ID);
-        if (index != -1)
-        {
-            MyData[index] = updatedItem;
-        }
+        // update the local view-model data with the service data
+        await GetGridData();
     }
 
-    // the following method mimics an actual data service that handles the actual data source
-    // you can see about implement error and exception handling, determining suitable return types as per your needs
-    // an example is available here: https://github.com/telerik/blazor-ui/tree/master/grid/remote-validation
+    //in a real case, keep the models in dedicated locations, this is just an easy to copy and see example
+    public class SampleData
+    {
+        public int ID { get; set; }
+        public string Name { get; set; }
+        public string Role { get; set; }
+    }
 
-    async Task<SampleData> ServiceMimicUpdate(SampleData itemToUpdate)
+    async Task GetGridData()
     {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        SampleData updatedItem = new SampleData()
-        {
-            ID = itemToUpdate.ID,
-            Name = itemToUpdate.Name,
-            Role = itemToUpdate.Role
-        };
-        return await Task.FromResult(updatedItem);
+        MyData = await MyService.Read();
+        Roles = await MyService.GetRoles();
+    }
+
+    protected override async Task OnInitializedAsync()
+    {
+        await GetGridData();
     }
 
-    protected override void OnInitialized()
+    // the following static class mimics an actual data service that handles the actual data source
+    // replace it with your actual service through the DI, this only mimics how the API can look like and works for this standalone page
+    public static class MyService
     {
-        MyData = new List<SampleData>();
+        private static List<SampleData> _data { get; set; } = new List<SampleData>();
+        private static List<string> Roles = new List<string> { "Manager", "Employee", "Contractor" };
 
-        for (int i = 0; i < 50; i++)
+        public static async Task<List<SampleData>> Read()
         {
-            MyData.Add(new SampleData()
+            if (_data.Count < 1)
             {
-                ID = i,
-                Name = "name " + i,
-                Role = Roles[i % Roles.Count]
-            });
-        }
-    }
+                for (int i = 1; i < 50; i++)
+                {
+                    _data.Add(new SampleData()
+                    {
+                        ID = i,
+                        Name = "Name " + i.ToString(),
+                        Role = Roles[i % Roles.Count]
+                    });
+                }
+            }
 
-    //in a real case, keep the models in dedicated locations, this is just an easy to copy and see example
-    public class SampleData
-    {
-        public int ID { get; set; }
-        public string Name { get; set; }
-        public string Role { get; set; }
-    }
+            return await Task.FromResult(_data);
+        }
 
-    public List<SampleData> MyData { get; set; }
+        public static async Task<List<string>> GetRoles()
+        {
+            return await Task.FromResult(Roles);
+        }
 
-    public static List<string> Roles = new List<string> { "Manager", "Employee", "Contractor" };
+        public static async Task Update(SampleData itemToUpdate)
+        {
+            var index = _data.FindIndex(i => i.ID == itemToUpdate.ID);
+            if (index != -1)
+            {
+                _data[index] = itemToUpdate;
+            }
+        }
+    }
 }
 ````
 
@@ -168,81 +181,84 @@ You can find the following examples below:
         Employee item = (Employee)args.Item;
 
         // perform actual data source operations here through your service
-        Employee updatedItem = await ServiceMimicUpdate(item);
+        await MyService.Update(item);
 
-        // update the local view-model data
-        var index = MyData.FindIndex(i => i.ID == updatedItem.ID);
-        if (index != -1)
-        {
-            MyData[index] = updatedItem;
-        }
+        // update the local view-model data with the service data
+        await GetGridData();
     }
 
-    // the following method mimics an actual data service that handles the actual data source
-    // you can see about implement error and exception handling, determining suitable return types as per your needs
-    // an example is available here: https://github.com/telerik/blazor-ui/tree/master/grid/remote-validation
-
-    async Task<Employee> ServiceMimicUpdate(Employee itemToUpdate)
+    public class Employee
     {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        Employee updatedItem = new Employee()
-        {
-            ID = itemToUpdate.ID,
-            Name = itemToUpdate.Name,
-            RoleId = itemToUpdate.RoleId
-        };
-        return await Task.FromResult(updatedItem);
+        public int ID { get; set; }
+        public string Name { get; set; }
+        public int RoleId { get; set; }
     }
 
-    protected override async Task OnInitializedAsync()
+    public class Role
     {
-        Roles = await GetRoles();
-        MyData = await GetGridData();
+        public int RoleId { get; set; }
+        public string RoleName { get; set; }
     }
 
-    async Task<List<Role>> GetRoles()
+    async Task GetGridData()
     {
-        var data = new List<Role>
-        {
-            new Role { RoleId = 1, RoleName = "Manager" },
-            new Role { RoleId = 2, RoleName = "Employee" },
-            new Role { RoleId = 3, RoleName = "Contractor" },
-        };
+        MyData = await MyService.Read();
+        Roles = await MyService.GetRoles();
+    }
 
-        return await Task.FromResult(data);
+    protected override async Task OnInitializedAsync()
+    {
+        await GetGridData();
     }
 
-    async Task<List<Employee>> GetGridData()
+    // the following static class mimics an actual data service that handles the actual data source
+    // replace it with your actual service through the DI, this only mimics how the API can look like and works for this standalone page
+    public static class MyService
     {
-        var data = new List<Employee>();
-        for (int i = 0; i < 50; i++)
+        private static List<Employee> _data { get; set; } = new List<Employee>();
+        private static List<string> Roles = new List<string> { "Manager", "Employee", "Contractor" };
+
+        public static async Task<List<Employee>> Read()
         {
-            data.Add(new Employee()
+            if (_data.Count < 1)
             {
-                ID = i,
-                Name = "name " + i,
-                RoleId = i % 4 // every one in four is an unknown one that will not be present in the roles list
-                               // and will have an ID of 0 to match the DefaultText of the dropdownlist
-                               // you can perform more complicated checks as necessary in your app and/or in the templates
-                               // and/or in the view-model data to present it with suitable values and avoid exceptions
-            });
+                for (int i = 0; i < 50; i++)
+                {
+                    _data.Add(new Employee()
+                    {
+                        ID = i,
+                        Name = "name " + i,
+                        RoleId = i % 4 // every one in four is an unknown one that will not be present in the roles list
+                                       // and will have an ID of 0 to match the DefaultText of the dropdownlist
+                                       // you can perform more complicated checks as necessary in your app and/or in the templates
+                                       // and/or in the view-model data to present it with suitable values and avoid exceptions
+                    });
+                }
+            }
+
+            return await Task.FromResult(_data);
         }
 
-        return await Task.FromResult(data);
-    }
+        public static async Task<List<Role>> GetRoles()
+        {
+            var data = new List<Role>
+            {
+                new Role { RoleId = 1, RoleName = "Manager" },
+                new Role { RoleId = 2, RoleName = "Employee" },
+                new Role { RoleId = 3, RoleName = "Contractor" },
+            };
 
-    public class Employee
-    {
-        public int ID { get; set; }
-        public string Name { get; set; }
-        public int RoleId { get; set; }
-    }
+            return await Task.FromResult(data);
+        }
 
-    public class Role
-    {
-        public int RoleId { get; set; }
-        public string RoleName { get; set; }
+        public static async Task Update(Employee itemToUpdate)
+        {
+            var index = _data.FindIndex(i => i.ID == itemToUpdate.ID);
+            if (index != -1)
+            {
+                _data[index] = itemToUpdate;
+            }
+        }
     }
 }
 ````

From 340242dd0716bfb947060823ae3a8eda87e15140 Mon Sep 17 00:00:00 2001
From: Marin Bratanov <m.bratanov@gmail.com>
Date: Sat, 7 Nov 2020 17:48:55 +0200
Subject: [PATCH 10/22] chore(grid): toolbar better CRUD mimic

---
 .../grid/images/create-toolbar-button.jpg     | Bin 88746 -> 0 bytes
 .../grid/images/create-toolbar-button.png     | Bin 0 -> 28957 bytes
 components/grid/toolbar.md                    | 112 ++++++++++--------
 3 files changed, 63 insertions(+), 49 deletions(-)
 delete mode 100644 components/grid/images/create-toolbar-button.jpg
 create mode 100644 components/grid/images/create-toolbar-button.png

diff --git a/components/grid/images/create-toolbar-button.jpg b/components/grid/images/create-toolbar-button.jpg
deleted file mode 100644
index 7f841cd08a40e22a1c571d3586c49ce937d58b3a..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 88746
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
XtajAn|AY4WKX)Sgx7+x+SL6Q$mOEAx

diff --git a/components/grid/images/create-toolbar-button.png b/components/grid/images/create-toolbar-button.png
new file mode 100644
index 0000000000000000000000000000000000000000..daac6d650384b52919ccd38941a68d16c3d8dd33
GIT binary patch
literal 28957
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
IT6P!z4@{Gk6951J

literal 0
HcmV?d00001

diff --git a/components/grid/toolbar.md b/components/grid/toolbar.md
index 8f325fd702..c439864d26 100644
--- a/components/grid/toolbar.md
+++ b/components/grid/toolbar.md
@@ -40,6 +40,7 @@ The grid offers built-in commands that you can invoke through its toolbar. To us
         <GridCommandButton Command="Add" Icon="add">Add Employee</GridCommandButton>
     </GridToolBar>
     <GridColumns>
+        <GridColumn Field=@nameof(SampleData.ID) Editable="false" Title="Employee ID" />
         <GridColumn Field=@nameof(SampleData.Name) Title="Employee Name" />
         <GridColumn Field=@nameof(SampleData.HireDate) Title="Hire Date" />
         <GridCommandColumn>
@@ -52,20 +53,17 @@ The grid offers built-in commands that you can invoke through its toolbar. To us
 
 @code {
     string result;
+    public List<SampleData> MyData { get; set; }
 
     private async Task UpdateHandler(GridCommandEventArgs args)
     {
         SampleData item = args.Item as SampleData;
 
         // perform actual data source operations here through your service
-        SampleData updatedItem = await ServiceMimicUpdate(item);
+        SampleData updatedItem = await MyService.Update(item);
 
-        // update the local view-model data
-        var index = MyData.FindIndex(i => i.ID == updatedItem.ID);
-        if (index != -1)
-        {
-            MyData[index] = updatedItem;
-        }
+        // update the local view-model data with the service data
+        await GetGridData();
 
         result = string.Format("Employee with ID {0} now has name {1} and hire date {2}", updatedItem.ID, updatedItem.Name, updatedItem.HireDate);
     }
@@ -74,67 +72,83 @@ The grid offers built-in commands that you can invoke through its toolbar. To us
     {
         SampleData item = args.Item as SampleData;
 
-        // perform actual data source operation here through your service
-        SampleData insertedItem = await ServiceMimicInsert(item);
+        // perform actual data source operations here through your service
+        SampleData insertedItem = await MyService.Create(item);
 
-        // update the local view-model data
-        MyData.Insert(0, insertedItem);
+        // update the local view-model data with the service data
+        await GetGridData();
 
         result = string.Format("On {2} you added the employee {0} who was hired on {1}.", insertedItem.Name, insertedItem.HireDate, DateTime.Now);
     }
 
-    // the following two methods mimic an actual data service that handles the actual data source
-    // you can see about implement error and exception handling, determining suitable return types as per your needs
-    // an example is available here: https://github.com/telerik/blazor-ui/tree/master/grid/remote-validation
-
-    async Task<SampleData> ServiceMimicInsert(SampleData itemToInsert)
+    //in a real case, keep the models in dedicated locations, this is just an easy to copy and see example
+    public class SampleData
     {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        SampleData updatedItem = new SampleData()
-        {
-            // the service assigns an ID, in this sample we use only the view-model data for simplicity,
-            // you should use the actual data and set the properties as necessary (e.g., generate nested fields data and so on)
-            ID = MyData.Count + 1,
-            Name = itemToInsert.Name,
-            HireDate = itemToInsert.HireDate
-        };
-        return await Task.FromResult(updatedItem);
+        public int ID { get; set; }
+        public string Name { get; set; }
+        public DateTime HireDate { get; set; }
     }
 
-    async Task<SampleData> ServiceMimicUpdate(SampleData itemToUpdate)
+    async Task GetGridData()
     {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        SampleData updatedItem = new SampleData()
-        {
-            ID = itemToUpdate.ID,
-            Name = itemToUpdate.Name,
-            HireDate = itemToUpdate.HireDate
-        };
-        return await Task.FromResult(updatedItem);
+        MyData = await MyService.Read();
     }
 
-    //in a real case, keep the models in dedicated locations, this is just an easy to copy and see example
-    public class SampleData
+    protected override async Task OnInitializedAsync()
     {
-        public int ID { get; set; }
-        public string Name { get; set; }
-        public DateTime HireDate { get; set; }
+        await GetGridData();
     }
 
-    public List<SampleData> MyData = Enumerable.Range(1, 50).Select(x => new SampleData
+    // the following static class mimics an actual data service that handles the actual data source
+    // replace it with your actual service through the DI, this only mimics how the API can look like and works for this standalone page
+    public static class MyService
     {
-        ID = x,
-        Name = "name " + x,
-        HireDate = DateTime.Now.AddDays(-x)
-    }).ToList();
+        private static List<SampleData> _data { get; set; } = new List<SampleData>();
+
+        public static async Task<SampleData> Create(SampleData itemToInsert)
+        {
+            itemToInsert.ID = _data.Count + 1;
+            _data.Insert(0, itemToInsert);
+
+            return await Task.FromResult(itemToInsert);
+        }
+
+        public static async Task<List<SampleData>> Read()
+        {
+            if (_data.Count < 1)
+            {
+                for (int i = 1; i < 50; i++)
+                {
+                    _data.Add(new SampleData()
+                    {
+                        ID = i,
+                        Name = "Name " + i.ToString(),
+                        HireDate = DateTime.Now.AddDays(-i)
+                    });
+                }
+            }
+
+            return await Task.FromResult(_data);
+        }
+
+        public static async Task<SampleData> Update(SampleData itemToUpdate)
+        {
+            var index = _data.FindIndex(i => i.ID == itemToUpdate.ID);
+            if (index != -1)
+            {
+                _data[index] = itemToUpdate;
+                return await Task.FromResult(_data[index]);
+            }
+
+            throw new Exception("no item to update");
+        }
+    }
 }
 ````
 
->caption The result from the code snippet above, after built-in Create button in the toolbar was clicked
+>caption The result from the code snippet above, after the built-in Create button in the toolbar was clicked
 
-![](images/create-toolbar-button.jpg)
+![](images/create-toolbar-button.png)
 
 ## Custom Commands
 

From 2033d2b594918edfdc653a2e9126c8161157157f Mon Sep 17 00:00:00 2001
From: Marin Bratanov <m.bratanov@gmail.com>
Date: Sat, 7 Nov 2020 17:55:26 +0200
Subject: [PATCH 11/22] chore(listview): better CRUD mimic

---
 components/listview/editing.md | 123 +++++++++++++++++----------------
 1 file changed, 65 insertions(+), 58 deletions(-)

diff --git a/components/listview/editing.md b/components/listview/editing.md
index 8b8b61611d..bb672f85d8 100644
--- a/components/listview/editing.md
+++ b/components/listview/editing.md
@@ -62,19 +62,18 @@ The CUD operations are implemented through dedicated events that let you alter t
 </TelerikListView>
 
 @code{
+    List<Employee> ListViewData { get; set; }
+    List<string> Teams { get; set; }
+
     async Task UpdateHandler(ListViewCommandEventArgs args)
     {
         Employee item = (Employee)args.Item;
 
-        // perform actual data source operations here through your service
-        Employee updatedItem = await ServiceMimicUpdate(item);
+        // perform actual data source operation here through your service
+        await MyService.Update(item);
 
         // update the local view-model data with the service data
-        var index = ListViewData.FindIndex(i => i.Id == updatedItem.Id);
-        if (index != -1)
-        {
-            ListViewData[index] = updatedItem;
-        }
+        await GetListViewData();
     }
 
     async Task DeleteHandler(ListViewCommandEventArgs args)
@@ -82,13 +81,10 @@ The CUD operations are implemented through dedicated events that let you alter t
         Employee item = (Employee)args.Item;
 
         // perform actual data source operation here through your service
-        bool isDeleted = await ServiceMimicDelete(item);
+        await MyService.Delete(item);
 
-        if (isDeleted)
-        {
-            // update the local view-model data
-            ListViewData.Remove(item);
-        }
+        // update the local view-model data with the service data
+        await GetListViewData();
     }
 
     async Task CreateHandler(ListViewCommandEventArgs args)
@@ -96,10 +92,10 @@ The CUD operations are implemented through dedicated events that let you alter t
         Employee item = (Employee)args.Item;
 
         // perform actual data source operation here through your service
-        Employee insertedItem = await ServiceMimicInsert(item);
+        await MyService.Create(item);
 
         // update the local view-model data with the service data
-        ListViewData.Insert(0, insertedItem);
+        await GetListViewData();
     }
 
     async Task EditHandler(ListViewCommandEventArgs e)
@@ -120,64 +116,75 @@ The CUD operations are implemented through dedicated events that let you alter t
         Console.WriteLine($"user changed item {changedItem.Id} to have Name: {changedItem.Name} and Team: {changedItem.Team}");
     }
 
-    // the following three methods mimic an actual data service that handles the actual data source
-    // you can see about implement error and exception handling, determining suitable return types as per your needs
-    // an example is available here: https://github.com/telerik/blazor-ui/tree/master/grid/remote-validation
+    // data and models follow
 
-    async Task<Employee> ServiceMimicInsert(Employee itemToInsert)
+    async Task GetListViewData()
     {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently, we use "new" here
-        Employee updatedItem = new Employee()
-        {
-            // the service assigns an ID, in this sample we use only the view-model data for simplicity,
-            // you should use the actual data and set the properties as necessary (e.g., generate nested fields data and so on)
-            Id = ListViewData.Count + 1,
-            Name = itemToInsert.Name,
-            Team = itemToInsert.Team
-        };
-        return await Task.FromResult(updatedItem);
+        ListViewData = await MyService.Read();
+        Teams = await MyService.GetTeams();
     }
 
-    async Task<Employee> ServiceMimicUpdate(Employee itemToUpdate)
+    protected override async Task OnInitializedAsync()
     {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        Employee updatedItem = new Employee()
-        {
-            Id = itemToUpdate.Id,
-            Name = itemToUpdate.Name,
-            Team = itemToUpdate.Team
-        };
-        return await Task.FromResult(updatedItem);
+        await GetListViewData();
     }
 
-    async Task<bool> ServiceMimicDelete(Employee itemToDelete)
+    public class Employee
     {
-        return await Task.FromResult(true);//always successful
+        public int Id { get; set; }
+        public string Name { get; set; }
+        public string Team { get; set; }
     }
 
-    // data and models follow
+    // the following static class mimics an actual data service that handles the actual data source
+    // replace it with your actual service through the DI, this only mimics how the API can look like and works for this standalone page
+    public static class MyService
+    {
+        private static List<Employee> _data { get; set; } = new List<Employee>();
+        private static List<string> _teams = new List<string> { "Sales", "Dev", "Support" };
 
-    List<Employee> ListViewData { get; set; }
+        public static async Task Create(Employee itemToInsert)
+        {
+            itemToInsert.Id = _data.Count + 1;
+            _data.Insert(0, itemToInsert);
+        }
 
-    protected override void OnInitialized()
-    {
-        ListViewData = Enumerable.Range(1, 250).Select(x => new Employee
+        public static async Task<List<Employee>> Read()
         {
-            Id = x,
-            Name = $"Name {x}",
-            Team = Teams[x % Teams.Count]
-        }).ToList();
-    }
+            if (_data.Count < 1)
+            {
+                for (int i = 1; i < 50; i++)
+                {
+                    _data.Add(new Employee()
+                    {
+                        Id = i,
+                        Name = $"Name {i}",
+                        Team = _teams[i % _teams.Count]
+                    });
+                }
+            }
+
+            return await Task.FromResult(_data);
+        }
 
-    List<string> Teams = new List<string> { "Sales", "Dev", "Support" };
+        public static async Task<List<string>> GetTeams()
+        {
+            return await Task.FromResult(_teams);
+        }
 
-    public class Employee
-    {
-        public int Id { get; set; }
-        public string Name { get; set; }
-        public string Team { get; set; }
+        public static async Task Update(Employee itemToUpdate)
+        {
+            var index = _data.FindIndex(i => i.Id == itemToUpdate.Id);
+            if (index != -1)
+            {
+                _data[index] = itemToUpdate;
+            }
+        }
+
+        public static async Task Delete(Employee itemToDelete)
+        {
+            _data.Remove(itemToDelete);
+        }
     }
 }
 ````

From 3827aef943b16a406c2848af47b70cd01aeab1ce Mon Sep 17 00:00:00 2001
From: Marin Bratanov <m.bratanov@gmail.com>
Date: Sat, 7 Nov 2020 18:04:09 +0200
Subject: [PATCH 12/22] chore(scheduler): better CRUD service mimic

---
 components/scheduler/edit-appointments.md | 175 ++++++++++------------
 1 file changed, 75 insertions(+), 100 deletions(-)

diff --git a/components/scheduler/edit-appointments.md b/components/scheduler/edit-appointments.md
index 1e5d85c527..0ce9c802a7 100644
--- a/components/scheduler/edit-appointments.md
+++ b/components/scheduler/edit-appointments.md
@@ -96,8 +96,6 @@ The example below shows the signature of the event handlers so you can copy the
 @* This sample implements only updates to the view model. Your app must also update the database in the CUD events.
     This example uses the default field names for data binding *@
 
-There is a deliberate delay in the CUD operations in this sample to showcase their async nature
-
 <TelerikScheduler Data="@Appointments"
                   OnUpdate="@UpdateAppointment"
                   OnCreate="@AddAppointment"
@@ -113,51 +111,46 @@ There is a deliberate delay in the CUD operations in this sample to showcase the
 </TelerikScheduler>
 
 @code {
+    // sample data and scheduler settings
+    public SchedulerView CurrView { get; set; } = SchedulerView.Week;
+    public DateTime StartDate { get; set; } = new DateTime(2019, 12, 2);
+    public DateTime DayStart { get; set; } = new DateTime(2000, 1, 1, 8, 0, 0); //the time portion is important
+
+    List<SchedulerAppointment> Appointments { get; set; }
+
     async Task UpdateAppointment(SchedulerUpdateEventArgs args)
     {
         SchedulerAppointment item = (SchedulerAppointment)args.Item;
 
         // perform actual data source operations here through your service
-        SchedulerAppointment updatedItem = await ServiceMimicUpdate(item);
+        await MyService.Update(item);
 
         // update the local view-model data with the service data
-        var index = Appointments.FindIndex(i => i.Id == updatedItem.Id);
-        if (index != -1)
-        {
-            Appointments[index] = updatedItem;
-        }
+        await GetSchedulerData();
     }
 
     async Task AddAppointment(SchedulerCreateEventArgs args)
     {
         SchedulerAppointment item = args.Item as SchedulerAppointment;
 
-        // perform actual data source operation here through your service
-        SchedulerAppointment insertedItem = await ServiceMimicInsert(item);
+        // perform actual data source operations here through your service
+        await MyService.Create(item);
 
         // update the local view-model data with the service data
-        Appointments.Add(insertedItem);
+        await GetSchedulerData();
     }
 
     async Task DeleteAppointment(SchedulerDeleteEventArgs args)
     {
         SchedulerAppointment item = (SchedulerAppointment)args.Item;
 
-        // perform actual data source operation here through your service
-        bool isDeleted = await ServiceMimicDelete(item);
+        // perform actual data source operations here through your service
+        await MyService.Delete(item);
 
-        if (isDeleted)
-        {
-            // update the local view-model data
-            Appointments.Remove(item);
-        }
+        // update the local view-model data with the service data
+        await GetSchedulerData();
 
         // see the comments in the service mimic method below.
-        // if you do perform additional data source updates, you may want to
-        // also fetch the entire scheduler data anew to ensure correct and fresh data
-        // this also applies to the other CUD methods above
-        // something like the following can refresh the data
-        // Appointments = await AppointmentService.GetData();
     }
 
     //Handlers for application logic flexibility
@@ -189,80 +182,40 @@ There is a deliberate delay in the CUD operations in this sample to showcase the
     }
 
 
-    // the following three methods mimic an actual data service that handles the actual data source
-    // you can see about implement error and exception handling, determining suitable return types as per your needs
-
-    async Task<SchedulerAppointment> ServiceMimicInsert(SchedulerAppointment itemToInsert)
+    public class SchedulerAppointment
     {
-        await Task.Delay(1000); // simulate actual long running async operation
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently, we use "new" here
-        SchedulerAppointment updatedItem = new SchedulerAppointment()
+        public Guid Id { get; set; }
+        public string Title { get; set; }
+        public string Description { get; set; }
+        public DateTime Start { get; set; }
+        public DateTime End { get; set; }
+        public bool IsAllDay { get; set; }
+        public string RecurrenceRule { get; set; }
+        public List<DateTime> RecurrenceExceptions { get; set; }
+        public Guid? RecurrenceId { get; set; }
+
+        public SchedulerAppointment()
         {
-            Id  = Guid.NewGuid(),
-            Title = itemToInsert.Title,
-            Description = itemToInsert.Description,
-            Start = itemToInsert.Start,
-            End = itemToInsert.End,
-            IsAllDay = itemToInsert.IsAllDay,
-            RecurrenceExceptions = itemToInsert.RecurrenceExceptions,
-            RecurrenceRule = itemToInsert.RecurrenceRule,
-            RecurrenceId = itemToInsert.RecurrenceId
-        };
-        return await Task.FromResult(updatedItem);
+            Id = Guid.NewGuid();
+        }
     }
 
-    async Task<SchedulerAppointment> ServiceMimicUpdate(SchedulerAppointment itemToUpdate)
+    async Task GetSchedulerData()
     {
-        await Task.Delay(1000); // simulate actual long running async operation
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        SchedulerAppointment updatedItem = new SchedulerAppointment()
-        {
-            Id = itemToUpdate.Id,
-            Title = itemToUpdate.Title,
-            Description = itemToUpdate.Description,
-            Start = itemToUpdate.Start,
-            End = itemToUpdate.End,
-            IsAllDay = itemToUpdate.IsAllDay,
-            RecurrenceExceptions = itemToUpdate.RecurrenceExceptions,
-            RecurrenceRule = itemToUpdate.RecurrenceRule,
-            RecurrenceId = itemToUpdate.RecurrenceId
-        };
-
-        return await Task.FromResult(updatedItem);
+        Appointments = await MyService.Read();
     }
 
-    async Task<bool> ServiceMimicDelete(SchedulerAppointment itemToDelete)
+    protected override async Task OnInitializedAsync()
     {
-        await Task.Delay(1000); // simulate actual long running async operation
-
-
-        if (itemToDelete.RecurrenceId != null)
-        {
-            // a recurrence exception was deleted, you may want to update
-            // the actual data source - an item where theItem.Id == item.RecurrenceId
-            // and remove the current exception date from the list of its RecurrenceExceptions
-        }
-
-        if (!string.IsNullOrEmpty(itemToDelete.RecurrenceRule) && itemToDelete.RecurrenceExceptions?.Count > 0)
-        {
-            // a recurring appointment was deleted that had exceptions, you may want to
-            // delete or update any exceptions from the data source - look for
-            // items where theItem.RecurrenceId == item.Id
-        }
-
-        return await Task.FromResult(true);//always successful
+        await GetSchedulerData();
     }
 
-
-    // sample data and scheduler settings
-    public SchedulerView CurrView { get; set; } = SchedulerView.Week;
-    public DateTime StartDate { get; set; } = new DateTime(2019, 12, 2);
-    public DateTime DayStart { get; set; } = new DateTime(2000, 1, 1, 8, 0, 0); //the time portion is important
-
-    List<SchedulerAppointment> Appointments = new List<SchedulerAppointment>()
+    // the following static class mimics an actual data service that handles the actual data source
+    // replace it with your actual service through the DI, this only mimics how the API can look like and works for this standalone page
+    public static class MyService
     {
+        private static List<SchedulerAppointment> _data { get; set; } = new List<SchedulerAppointment>()
+        {
             new SchedulerAppointment
             {
                 Title = "Board meeting",
@@ -304,23 +257,45 @@ There is a deliberate delay in the CUD operations in this sample to showcase the
                 End = new DateTime(2019, 11, 27, 9, 30, 0),
                 RecurrenceRule = "FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR"
             }
-    };
+        };
 
-    public class SchedulerAppointment
-    {
-        public Guid Id { get; set; }
-        public string Title { get; set; }
-        public string Description { get; set; }
-        public DateTime Start { get; set; }
-        public DateTime End { get; set; }
-        public bool IsAllDay { get; set; }
-        public string RecurrenceRule { get; set; }
-        public List<DateTime> RecurrenceExceptions { get; set; }
-        public Guid? RecurrenceId { get; set; }
+        public static async Task Create(SchedulerAppointment itemToInsert)
+        {
+            itemToInsert.Id = Guid.NewGuid();
+            _data.Insert(0, itemToInsert);
+        }
 
-        public SchedulerAppointment()
+        public static async Task<List<SchedulerAppointment>> Read()
         {
-            Id = Guid.NewGuid();
+            return await Task.FromResult(_data);
+        }
+
+        public static async Task Update(SchedulerAppointment itemToUpdate)
+        {
+            var index = _data.FindIndex(i => i.Id == itemToUpdate.Id);
+            if (index != -1)
+            {
+                _data[index] = itemToUpdate;
+            }
+        }
+
+        public static async Task Delete(SchedulerAppointment itemToDelete)
+        {
+            if (itemToDelete.RecurrenceId != null)
+            {
+                // a recurrence exception was deleted, you may want to update
+                // the rest of the data source - find an item where theItem.Id == itemToDelete.RecurrenceId
+                // and remove the current exception date from the list of its RecurrenceExceptions
+            }
+
+            if (!string.IsNullOrEmpty(itemToDelete.RecurrenceRule) && itemToDelete.RecurrenceExceptions?.Count > 0)
+            {
+                // a recurring appointment was deleted that had exceptions, you may want to
+                // delete or update any exceptions from the data source - look for
+                // items where theItem.RecurrenceId == itemToDelete.Id
+            }
+
+            _data.Remove(itemToDelete);
         }
     }
 }

From 3e323a8cf61c0715a48e75daaf8a0a6490053d4d Mon Sep 17 00:00:00 2001
From: Marin Bratanov <m.bratanov@gmail.com>
Date: Sat, 7 Nov 2020 18:07:07 +0200
Subject: [PATCH 13/22] docs(grid): clarify why async Task and not async void

---
 components/grid/editing/overview.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/components/grid/editing/overview.md b/components/grid/editing/overview.md
index b9b9ea37da..f051bc8dda 100644
--- a/components/grid/editing/overview.md
+++ b/components/grid/editing/overview.md
@@ -235,7 +235,9 @@ There are a few considerations to keep in mind with the CUD operations of the gr
     
     * For example, you may want to update the view-model only on success of the data service with the model returned from the server. Another thing you may want to do is to inform the user for server (async, remote) validation errors such as duplicates. You can find examples of both in the [Remote Validation sample project](https://github.com/telerik/blazor-ui/tree/master/grid/remote-validation).
 
-* The CRUD event handlers must be `async Task` and **not** `async void`. A Task can be properly awaited and allows working with services and contexts. When the method returns `void`, the execution of the context operations is not actually awaited, and you may get errors from the context (such as "Cannot access a disposed object. A common cause of this error is disposing a context that was resolved from dependency injection and then later trying to use the same context instance elsewhere in your application" or "A second operation started on this context before a previous operation completed. This is usually caused by different threads using the same instance of DbContext").
+* The CRUD event handlers must be `async Task` and **not** `async void`. A Task can be properly awaited and allows working with services and contexts, and lets the grid update after the actual data source operations complete.
+
+    * When the method returns `void`, the execution of the context operations is not actually awaited, and you may get errors from the context (such as "Cannot access a disposed object. A common cause of this error is disposing a context that was resolved from dependency injection and then later trying to use the same context instance elsewhere in your application" or "A second operation started on this context before a previous operation completed. This is usually caused by different threads using the same instance of DbContext"). The grid may also re-render before the actual data update happens and you may not see the result.
 
 * The Grid uses `Activator.CreateInstance<TItem>();` to generate a new item when an Insert action is invoked, so the Model should have a Parameterless constructor defined. A workaround might be [invoking Insert through the grid state]({%slug grid-state%}#initiate-editing-or-inserting-of-an-item) and creating the object with your own code.
 

From 11300762752d9d4e8f04f88245d24cb8b7895eb3 Mon Sep 17 00:00:00 2001
From: Marin Bratanov <m.bratanov@gmail.com>
Date: Sat, 7 Nov 2020 18:16:27 +0200
Subject: [PATCH 14/22] chore(treelist): autogen columns better CRUD mimic

---
 components/treelist/columns/auto-generated.md | 112 +++++++++---------
 1 file changed, 55 insertions(+), 57 deletions(-)

diff --git a/components/treelist/columns/auto-generated.md b/components/treelist/columns/auto-generated.md
index cb89c99dff..c66e38777e 100644
--- a/components/treelist/columns/auto-generated.md
+++ b/components/treelist/columns/auto-generated.md
@@ -333,11 +333,6 @@ This example shows how to:
 @code {
     public List<Employee> Data { get; set; }
 
-    protected override async Task OnInitializedAsync()
-    {
-        Data = await GetTreeListData();
-    }
-
     // sample models with annotations
 
     public class Employee
@@ -380,78 +375,81 @@ This example shows how to:
         var item = e.Item as Employee;
 
         // perform actual data source operations here through your service
-        Employee updatedItem = await ServiceMimicUpdate(item);
+        await MyService.Update(item);
 
         // update the local view-model data with the service data
-        var index = Data.FindIndex(x => x.Id == updatedItem.Id);
-        if (index != -1)
-        {
-            // see the Equals override in the model - it ensures this is the same
-            // object from the treelist point of view and its state
-            Data[index] = updatedItem;
-        }
+        await GetTreeListData();
     }
 
-    // the following method mimics an actual data service that handles the actual data source
-    // you can see about implement error and exception handling, determining suitable return types as per your needs
+    // data generation
 
-    async Task<Employee> ServiceMimicUpdate(Employee itemToUpdate)
+    async Task GetTreeListData()
     {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        Employee updatedItem = new Employee()
-        {
-            Id = itemToUpdate.Id,
-            ParentId = itemToUpdate.ParentId,
-            Name = itemToUpdate.Name,
-            EmailAddress = itemToUpdate.EmailAddress,
-            HireDate = itemToUpdate.HireDate
-        };
-        return await Task.FromResult(updatedItem);
+        Data = await MyService.Read();
     }
 
-    // data generation
+    protected override async Task OnInitializedAsync()
+    {
+        await GetTreeListData();
+    }
 
-    async Task<List<Employee>> GetTreeListData()
+    // the following static class mimics an actual data service that handles the actual data source
+    // replace it with your actual service through the DI, this only mimics how the API can look like and works for this standalone page
+    public static class MyService
     {
-        List<Employee> data = new List<Employee>();
+        private static List<Employee> _data { get; set; } = new List<Employee>();
 
-        for (int i = 1; i < 15; i++)
+        public static async Task<List<Employee>> Read()
         {
-            data.Add(new Employee
-            {
-                Id = i,
-                ParentId = null,
-                Name = $"root: {i}",
-                HireDate = DateTime.Now.AddYears(-i)
-            }); ;
-
-            for (int j = 1; j < 4; j++)
+            if (_data.Count < 1)
             {
-                int currId = i * 100 + j;
-                data.Add(new Employee
-                {
-                    Id = currId,
-                    ParentId = i,
-                    Name = $"first level child {j} of {i}",
-                    HireDate = DateTime.Now.AddDays(-currId)
-                });
-
-                for (int k = 1; k < 3; k++)
+                for (int i = 1; i < 15; i++)
                 {
-                    int nestedId = currId * 1000 + k;
-                    data.Add(new Employee
+                    _data.Add(new Employee
                     {
-                        Id = nestedId,
-                        ParentId = currId,
-                        Name = $"second level child {k} of {i} and {currId}",
-                        HireDate = DateTime.Now.AddMinutes(-nestedId)
+                        Id = i,
+                        ParentId = null,
+                        Name = $"root: {i}",
+                        HireDate = DateTime.Now.AddYears(-i)
                     }); ;
+
+                    for (int j = 1; j < 4; j++)
+                    {
+                        int currId = i * 100 + j;
+                        _data.Add(new Employee
+                        {
+                            Id = currId,
+                            ParentId = i,
+                            Name = $"first level child {j} of {i}",
+                            HireDate = DateTime.Now.AddDays(-currId)
+                        });
+
+                        for (int k = 1; k < 3; k++)
+                        {
+                            int nestedId = currId * 1000 + k;
+                            _data.Add(new Employee
+                            {
+                                Id = nestedId,
+                                ParentId = currId,
+                                Name = $"second level child {k} of {i} and {currId}",
+                                HireDate = DateTime.Now.AddMinutes(-nestedId)
+                            }); ;
+                        }
+                    }
                 }
             }
+
+            return await Task.FromResult(_data);
         }
 
-        return await Task.FromResult(data);
+        public static async Task Update(Employee itemToUpdate)
+        {
+            var index = _data.FindIndex(i => i.Id == itemToUpdate.Id);
+            if (index != -1)
+            {
+                _data[index] = itemToUpdate;
+            }
+        }
     }
 }
 ````

From 49fb0751e2db95eeaba4449c5f7e494180103c0f Mon Sep 17 00:00:00 2001
From: Marin Bratanov <m.bratanov@gmail.com>
Date: Sat, 7 Nov 2020 19:34:03 +0200
Subject: [PATCH 15/22] chore(treeList): command column better CRUD mimic

---
 components/treelist/columns/command.md | 168 ++++++++++++-------------
 1 file changed, 81 insertions(+), 87 deletions(-)

diff --git a/components/treelist/columns/command.md b/components/treelist/columns/command.md
index a887788181..d35e24802d 100644
--- a/components/treelist/columns/command.md
+++ b/components/treelist/columns/command.md
@@ -76,8 +76,6 @@ The `OnClick` handler of the commands receives an argument of type `TreeListComm
 
 @code {
     public List<Employee> Data { get; set; }
-    public static List<string> Roles = new List<string> { "Manager", "Employee", "Contractor" };
-    public Employee CurrentlyEditedEmployee { get; set; }
 
     // Sample CUD operations for the local data
     async Task UpdateItem(TreeListCommandEventArgs args)
@@ -85,10 +83,10 @@ The `OnClick` handler of the commands receives an argument of type `TreeListComm
         var item = args.Item as Employee; // you can also use the entire model
 
         // perform actual data source operations here through your service
-        Employee updatedItem = await ServiceMimicUpdate(item);
+        await MyService.Update(item);
 
         // update the local view-model data with the service data
-        UpdateItemRecursive(Data, updatedItem);
+        await GetTreeListData();
     }
 
     // sample custom command handling
@@ -115,45 +113,6 @@ The `OnClick` handler of the commands receives an argument of type `TreeListComm
         await Task.Delay(2000); //simulate actual long running async operation
     }
 
-    // sample helper methods for handling the view-model data hierarchy
-    void UpdateItemRecursive(List<Employee> items, Employee itemToUpdate)
-    {
-        for (int i = 0; i < items.Count; i++)
-        {
-            if (items[i].Id.Equals(itemToUpdate.Id))
-            {
-                items[i] = itemToUpdate;
-                return;
-            }
-
-            if (items[i].DirectReports?.Count > 0)
-            {
-                UpdateItemRecursive(items[i].DirectReports, itemToUpdate);
-            }
-        }
-    }
-
-
-    // the following method mimics an actual data service that handles the actual data source
-    // you can see about implement error and exception handling, determining suitable return types as per your needs
-
-    async Task<Employee> ServiceMimicUpdate(Employee itemToUpdate)
-    {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        Employee updatedItem = new Employee()
-        {
-            Id = itemToUpdate.Id,
-            Name = itemToUpdate.Name,
-            EmailAddress = itemToUpdate.EmailAddress,
-            HireDate = itemToUpdate.HireDate,
-            HasChildren = itemToUpdate.HasChildren,
-            DirectReports = itemToUpdate.DirectReports
-        };
-        return await Task.FromResult(updatedItem);
-    }
-
-
     // sample model
 
     public class Employee
@@ -180,69 +139,104 @@ The `OnClick` handler of the commands receives an argument of type `TreeListComm
         }
     }
 
-
     // data generation
 
-    // used in this example for data generation and retrieval for CUD operations on the current view-model data
-    public int LastId { get; set; } = 1;
+    async Task GetTreeListData()
+    {
+        Data = await MyService.Read();
+    }
 
     protected override async Task OnInitializedAsync()
     {
-        Data = await GetTreeListData();
+        await GetTreeListData();
     }
 
-    async Task<List<Employee>> GetTreeListData()
+    // the following static class mimics an actual data service that handles the actual data source
+    // replace it with your actual service through the DI, this only mimics how the API can look like and works for this standalone page
+    public static class MyService
     {
-        List<Employee> data = new List<Employee>();
+        private static List<Employee> _data { get; set; } = new List<Employee>();
+        // used in this example for data generation and retrieval for CUD operations on the current view-model data
+        private static int LastId { get; set; } = 1;
+        private static List<string> Roles = new List<string> { "Manager", "Employee", "Contractor" };
 
-        for (int i = 1; i < 15; i++)
+        public static async Task<List<Employee>> Read()
         {
-            Employee root = new Employee
-            {
-                Id = LastId,
-                Name = $"root: {i}",
-                Role = Roles[i % Roles.Count],
-                EmailAddress = $"{i}@example.com",
-                HireDate = DateTime.Now.AddYears(-i),
-                DirectReports = new List<Employee>(),
-                HasChildren = true
-            };
-            data.Add(root);
-            LastId++;
-
-            for (int j = 1; j < 4; j++)
+            if (_data.Count < 1)
             {
-                int currId = LastId;
-                Employee firstLevelChild = new Employee
-                {
-                    Id = currId,
-                    Name = $"first level child {j} of {i}",
-                    Role = Roles[j % Roles.Count],
-                    EmailAddress = $"{currId}@example.com",
-                    HireDate = DateTime.Now.AddDays(-currId),
-                    DirectReports = new List<Employee>(),
-                    HasChildren = true
-                };
-                root.DirectReports.Add(firstLevelChild);
-                LastId++;
-
-                for (int k = 1; k < 3; k++)
+                for (int i = 1; i < 15; i++)
                 {
-                    int nestedId = LastId;
-                    firstLevelChild.DirectReports.Add(new Employee
+                    Employee root = new Employee
                     {
                         Id = LastId,
-                        Name = $"second level child {k} of {j} and {i}",
-                        Role = Roles[k % Roles.Count],
-                        EmailAddress = $"{nestedId}@example.com",
-                        HireDate = DateTime.Now.AddMinutes(-nestedId)
-                    }); ;
+                        Name = $"root: {i}",
+                        Role = Roles[i % Roles.Count],
+                        EmailAddress = $"{i}@example.com",
+                        HireDate = DateTime.Now.AddYears(-i),
+                        DirectReports = new List<Employee>(),
+                        HasChildren = true
+                    };
+                    _data.Add(root);
                     LastId++;
+
+                    for (int j = 1; j < 4; j++)
+                    {
+                        int currId = LastId;
+                        Employee firstLevelChild = new Employee
+                        {
+                            Id = currId,
+                            Name = $"first level child {j} of {i}",
+                            Role = Roles[j % Roles.Count],
+                            EmailAddress = $"{currId}@example.com",
+                            HireDate = DateTime.Now.AddDays(-currId),
+                            DirectReports = new List<Employee>(),
+                            HasChildren = true
+                        };
+                        root.DirectReports.Add(firstLevelChild);
+                        LastId++;
+
+                        for (int k = 1; k < 3; k++)
+                        {
+                            int nestedId = LastId;
+                            firstLevelChild.DirectReports.Add(new Employee
+                            {
+                                Id = LastId,
+                                Name = $"second level child {k} of {j} and {i}",
+                                Role = Roles[k % Roles.Count],
+                                EmailAddress = $"{nestedId}@example.com",
+                                HireDate = DateTime.Now.AddMinutes(-nestedId)
+                            }); ;
+                            LastId++;
+                        }
+                    }
                 }
             }
+
+            return await Task.FromResult(_data);
+        }
+
+        public static async Task Update(Employee itemToUpdate)
+        {
+            UpdateItemRecursive(_data, itemToUpdate);
         }
 
-        return await Task.FromResult(data);
+        // sample helper methods for handling the view-model data hierarchy
+        private static void UpdateItemRecursive(List<Employee> items, Employee itemToUpdate)
+        {
+            for (int i = 0; i < items.Count; i++)
+            {
+                if (items[i].Id.Equals(itemToUpdate.Id))
+                {
+                    items[i] = itemToUpdate;
+                    return;
+                }
+
+                if (items[i].DirectReports?.Count > 0)
+                {
+                    UpdateItemRecursive(items[i].DirectReports, itemToUpdate);
+                }
+            }
+        }
     }
 }
 ````

From 4ff3d3ec3a5b8437fae680b7e956568bfdfdc219 Mon Sep 17 00:00:00 2001
From: Marin Bratanov <m.bratanov@gmail.com>
Date: Sat, 7 Nov 2020 19:50:15 +0200
Subject: [PATCH 16/22] chore(treeList): incell edit better CRUD mimic

---
 components/treelist/editing/incell.md | 297 ++++++++++++--------------
 1 file changed, 139 insertions(+), 158 deletions(-)

diff --git a/components/treelist/editing/incell.md b/components/treelist/editing/incell.md
index bddfedb79f..feca579a89 100644
--- a/components/treelist/editing/incell.md
+++ b/components/treelist/editing/incell.md
@@ -44,9 +44,8 @@ Editing is cancelled for the first record.
         <TreeListCommandButton Command="Add" Icon="add">Add</TreeListCommandButton>
     </TreeListToolBar>
     <TreeListColumns>
-        <TreeListCommandColumn Width="280px">
+        <TreeListCommandColumn Width="200px">
             <TreeListCommandButton Command="Add" Icon="@IconName.Plus">Add Child</TreeListCommandButton>
-            <TreeListCommandButton Command="Edit" Icon="@IconName.Edit">Edit</TreeListCommandButton>
             <TreeListCommandButton Command="Delete" Icon="@IconName.Delete">Delete</TreeListCommandButton>
             <TreeListCommandButton Command="Save" Icon="@IconName.Save" ShowInEdit="true">Update</TreeListCommandButton>
             <TreeListCommandButton Command="Cancel" Icon="@IconName.Cancel" ShowInEdit="true">Cancel</TreeListCommandButton>
@@ -71,21 +70,22 @@ Editing is cancelled for the first record.
         var item = args.Item as Employee; // you can also use the entire model
 
         // perform actual data source operations here through your service
-        Employee updatedItem = await ServiceMimicUpdate(item);
+        await MyService.Update(item);
 
         // update the local view-model data with the service data
-        UpdateItemRecursive(Data, updatedItem);
+        await GetTreeListData();
     }
 
     async Task CreateItem(TreeListCommandEventArgs args)
     {
-        var argsItem = args.Item as Employee;
+        var item = args.Item as Employee;
+        var parentItem = args.ParentItem as Employee;
 
-        // perform actual data source operation here through your service
-        Employee insertedItem = await ServiceMimicInsert(argsItem);
+        // perform actual data source operations here through your service
+        await MyService.Create(item, parentItem);
 
         // update the local view-model data with the service data
-        InsertItemRecursive(Data, insertedItem, args);
+        await GetTreeListData();
     }
 
     async Task DeleteItem(TreeListCommandEventArgs args)
@@ -93,73 +93,10 @@ Editing is cancelled for the first record.
         var item = args.Item as Employee;
 
         // perform actual data source operations here through your service
-        bool isDeleted = await ServiceMimicDelete(item);
-
-        if (isDeleted)
-        {
-            // update the local view-model data
-            RemoveChildRecursive(Data, item);
-        }
-    }
-
-    // sample helper methods for handling the view-model data hierarchy
-    void InsertItemRecursive(List<Employee> Data, Employee insertedItem, TreeListCommandEventArgs args)
-    {
-        if (args.ParentItem != null)
-        {
-            var parent = (Employee)args.ParentItem;
-
-            parent.HasChildren = true;
-            if (parent.DirectReports == null)
-            {
-                parent.DirectReports = new List<Employee>();
-            }
-
-            parent.DirectReports.Insert(0, insertedItem);
-        }
-        else
-        {
-            Data.Insert(0, insertedItem);
-        }
-    }
-
-    void UpdateItemRecursive(List<Employee> items, Employee itemToUpdate)
-    {
-        for (int i = 0; i < items.Count; i++)
-        {
-            if (items[i].Id.Equals(itemToUpdate.Id))
-            {
-                items[i] = itemToUpdate;
-                return;
-            }
-
-            if (items[i].DirectReports?.Count > 0)
-            {
-                UpdateItemRecursive(items[i].DirectReports, itemToUpdate);
-            }
-        }
-    }
+        await MyService.Delete(item);
 
-    void RemoveChildRecursive(List<Employee> items, Employee item)
-    {
-        for (int i = 0; i < items.Count(); i++)
-        {
-            if (item.Equals(items[i]))
-            {
-                items.Remove(item);
-
-                return;
-            }
-            else if (items[i].DirectReports?.Count > 0)
-            {
-                RemoveChildRecursive(items[i].DirectReports, item);
-
-                if (items[i].DirectReports.Count == 0)
-                {
-                    items[i].HasChildren = false;
-                }
-            }
-        }
+        // update the local view-model data with the service data
+        await GetTreeListData();
     }
 
     // OnEdit handler
@@ -184,49 +121,6 @@ Editing is cancelled for the first record.
     }
 
 
-    // the following three methods mimic an actual data service that handles the actual data source
-    // you can see about implement error and exception handling, determining suitable return types as per your needs
-
-    async Task<Employee> ServiceMimicInsert(Employee itemToInsert)
-    {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently, we use "new" here
-        Employee insertedItem = new Employee()
-        {
-            // the service assigns an ID, in this sample we use only the view-model data for simplicity,
-            // you should use the actual data and set the properties as necessary (e.g., generate nested fields data and so on)
-            Id = LastId++,
-            Name = itemToInsert.Name,
-            EmailAddress = itemToInsert.EmailAddress,
-            HireDate = itemToInsert.HireDate,
-            HasChildren = itemToInsert.HasChildren,
-            DirectReports = itemToInsert.DirectReports
-        };
-        return await Task.FromResult(insertedItem);
-    }
-
-    async Task<Employee> ServiceMimicUpdate(Employee itemToUpdate)
-    {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        Employee updatedItem = new Employee()
-        {
-            Id = itemToUpdate.Id,
-            Name = itemToUpdate.Name,
-            EmailAddress = itemToUpdate.EmailAddress,
-            HireDate = itemToUpdate.HireDate,
-            HasChildren = itemToUpdate.HasChildren,
-            DirectReports = itemToUpdate.DirectReports
-        };
-        return await Task.FromResult(updatedItem);
-    }
-
-    async Task<bool> ServiceMimicDelete(Employee itemToDelete)
-    {
-        return await Task.FromResult(true);//always successful
-    }
-
-
     // sample model
 
     public class Employee
@@ -253,65 +147,152 @@ Editing is cancelled for the first record.
     }
 
     // data generation
-    // used in this example for data generation and assigning an ID to newly inserted items
-    public int LastId { get; set; } = 1;
+
+    async Task GetTreeListData()
+    {
+        Data = await MyService.Read();
+    }
 
     protected override async Task OnInitializedAsync()
     {
-        Data = await GetTreeListData();
+        await GetTreeListData();
     }
 
-    async Task<List<Employee>> GetTreeListData()
+    // the following static class mimics an actual data service that handles the actual data source
+    // replace it with your actual service through the DI, this only mimics how the API can look like and works for this standalone page
+    public static class MyService
     {
-        List<Employee> data = new List<Employee>();
+        private static List<Employee> _data { get; set; } = new List<Employee>();
+        // used in this example for data generation and retrieval for CUD operations on the current view-model data
+        private static int LastId { get; set; } = 1;
 
-        for (int i = 1; i < 15; i++)
+        public static async Task Create(Employee itemToInsert, Employee parentItem)
         {
-            Employee root = new Employee
-            {
-                Id = LastId,
-                Name = $"root: {i}",
-                EmailAddress = $"{i}@example.com",
-                HireDate = DateTime.Now.AddYears(-i),
-                DirectReports = new List<Employee>(),
-                HasChildren = true
-            };
-            data.Add(root);
-            LastId++;
-
-            for (int j = 1; j < 4; j++)
+            InsertItemRecursive(_data, itemToInsert, parentItem);
+        }
+
+        public static async Task<List<Employee>> Read()
+        {
+            if (_data.Count < 1)
             {
-                int currId = LastId;
-                Employee firstLevelChild = new Employee
+                for (int i = 1; i < 15; i++)
                 {
-                    Id = currId,
-                    Name = $"first level child {j} of {i}",
-                    EmailAddress = $"{currId}@example.com",
-                    HireDate = DateTime.Now.AddDays(-currId),
-                    DirectReports = new List<Employee>(),
-                    HasChildren = true
-                };
-                root.DirectReports.Add(firstLevelChild);
-                LastId++;
-
-                for (int k = 1; k < 3; k++)
-                {
-                    int nestedId = LastId;
-                    firstLevelChild.DirectReports.Add(new Employee
+                    Employee root = new Employee
                     {
                         Id = LastId,
-                        Name = $"second level child {k} of {j} and {i}",
-                        EmailAddress = $"{nestedId}@example.com",
-                        HireDate = DateTime.Now.AddMinutes(-nestedId)
-                    }); ;
+                        Name = $"root: {i}",
+                        EmailAddress = $"{i}@example.com",
+                        HireDate = DateTime.Now.AddYears(-i),
+                        DirectReports = new List<Employee>(),
+                        HasChildren = true
+                    };
+                    _data.Add(root);
                     LastId++;
+
+                    for (int j = 1; j < 4; j++)
+                    {
+                        int currId = LastId;
+                        Employee firstLevelChild = new Employee
+                        {
+                            Id = currId,
+                            Name = $"first level child {j} of {i}",
+                            EmailAddress = $"{currId}@example.com",
+                            HireDate = DateTime.Now.AddDays(-currId),
+                            DirectReports = new List<Employee>(),
+                            HasChildren = true
+                        };
+                        root.DirectReports.Add(firstLevelChild);
+                        LastId++;
+
+                        for (int k = 1; k < 3; k++)
+                        {
+                            int nestedId = LastId;
+                            firstLevelChild.DirectReports.Add(new Employee
+                            {
+                                Id = LastId,
+                                Name = $"second level child {k} of {j} and {i}",
+                                EmailAddress = $"{nestedId}@example.com",
+                                HireDate = DateTime.Now.AddMinutes(-nestedId)
+                            }); ;
+                            LastId++;
+                        }
+                    }
                 }
+
+                _data[0].Name += " (non-editable, see OnEdit)";
             }
+
+            return await Task.FromResult(_data);
         }
 
-        data[0].Name += " (non-editable, see OnEdit)";
+        public static async Task Update(Employee itemToUpdate)
+        {
+            UpdateItemRecursive(_data, itemToUpdate);
+        }
 
-        return await Task.FromResult(data);
+        public static async Task Delete(Employee itemToDelete)
+        {
+            RemoveChildRecursive(_data, itemToDelete);
+        }
+
+        // sample helper methods for handling the view-model data hierarchy
+        static void UpdateItemRecursive(List<Employee> items, Employee itemToUpdate)
+        {
+            for (int i = 0; i < items.Count; i++)
+            {
+                if (items[i].Id.Equals(itemToUpdate.Id))
+                {
+                    items[i] = itemToUpdate;
+                    return;
+                }
+
+                if (items[i].DirectReports?.Count > 0)
+                {
+                    UpdateItemRecursive(items[i].DirectReports, itemToUpdate);
+                }
+            }
+        }
+
+        static void RemoveChildRecursive(List<Employee> items, Employee item)
+        {
+            for (int i = 0; i < items.Count(); i++)
+            {
+                if (item.Equals(items[i]))
+                {
+                    items.Remove(item);
+
+                    return;
+                }
+                else if (items[i].DirectReports?.Count > 0)
+                {
+                    RemoveChildRecursive(items[i].DirectReports, item);
+
+                    if (items[i].DirectReports.Count == 0)
+                    {
+                        items[i].HasChildren = false;
+                    }
+                }
+            }
+        }
+
+        static void InsertItemRecursive(List<Employee> Data, Employee insertedItem, Employee parentItem)
+        {
+            insertedItem.Id = LastId++;
+            if (parentItem != null)
+            {
+                parentItem.HasChildren = true;
+                if (parentItem.DirectReports == null)
+                {
+                    parentItem.DirectReports = new List<Employee>();
+                }
+
+                parentItem.DirectReports.Insert(0, insertedItem);
+            }
+            else
+            {
+                Data.Insert(0, insertedItem);
+            }
+        }
     }
 }
 ````

From 27590f748d82bd353e0e097a8b3e08c1d2f39519 Mon Sep 17 00:00:00 2001
From: Marin Bratanov <m.bratanov@gmail.com>
Date: Sat, 7 Nov 2020 19:57:08 +0200
Subject: [PATCH 17/22] chore(treeList): inline edit better CRUD mimic

---
 components/treelist/editing/inline.md | 294 ++++++++++++--------------
 1 file changed, 139 insertions(+), 155 deletions(-)

diff --git a/components/treelist/editing/inline.md b/components/treelist/editing/inline.md
index 2e9e31e431..7eeb45245d 100644
--- a/components/treelist/editing/inline.md
+++ b/components/treelist/editing/inline.md
@@ -53,6 +53,7 @@ Editing is cancelled for the first record.
     </TreeListColumns>
 </TelerikTreeList>
 
+
 @code {
     public List<Employee> Data { get; set; }
 
@@ -62,21 +63,22 @@ Editing is cancelled for the first record.
         var item = args.Item as Employee;
 
         // perform actual data source operations here through your service
-        Employee updatedItem = await ServiceMimicUpdate(item);
+        await MyService.Update(item);
 
         // update the local view-model data with the service data
-        UpdateItemRecursive(Data, updatedItem);
+        await GetTreeListData();
     }
 
     async Task CreateItem(TreeListCommandEventArgs args)
     {
-        var argsItem = args.Item as Employee;
+        var item = args.Item as Employee;
+        var parentItem = args.ParentItem as Employee;
 
-        // perform actual data source operation here through your service
-        Employee insertedItem = await ServiceMimicInsert(argsItem);
+        // perform actual data source operations here through your service
+        await MyService.Create(item, parentItem);
 
         // update the local view-model data with the service data
-        InsertItemRecursive(Data, insertedItem, args);
+        await GetTreeListData();
     }
 
     async Task DeleteItem(TreeListCommandEventArgs args)
@@ -84,73 +86,10 @@ Editing is cancelled for the first record.
         var item = args.Item as Employee;
 
         // perform actual data source operations here through your service
-        bool isDeleted = await ServiceMimicDelete(item);
-
-        if (isDeleted)
-        {
-            // update the local view-model data
-            RemoveChildRecursive(Data, item);
-        }
-    }
-
-    // sample helper methods for handling the view-model data hierarchy
-    void InsertItemRecursive(List<Employee> Data, Employee insertedItem, TreeListCommandEventArgs args)
-    {
-        if (args.ParentItem != null)
-        {
-            var parent = (Employee)args.ParentItem;
-
-            parent.HasChildren = true;
-            if (parent.DirectReports == null)
-            {
-                parent.DirectReports = new List<Employee>();
-            }
-
-            parent.DirectReports.Insert(0, insertedItem);
-        }
-        else
-        {
-            Data.Insert(0, insertedItem);
-        }
-    }
-
-    void UpdateItemRecursive(List<Employee> items, Employee itemToUpdate)
-    {
-        for (int i = 0; i < items.Count; i++)
-        {
-            if (items[i].Id.Equals(itemToUpdate.Id))
-            {
-                items[i] = itemToUpdate;
-                return;
-            }
-
-            if (items[i].DirectReports?.Count > 0)
-            {
-                UpdateItemRecursive(items[i].DirectReports, itemToUpdate);
-            }
-        }
-    }
-
-    void RemoveChildRecursive(List<Employee> items, Employee item)
-    {
-        for (int i = 0; i < items.Count(); i++)
-        {
-            if (item.Equals(items[i]))
-            {
-                items.Remove(item);
+        await MyService.Delete(item);
 
-                return;
-            }
-            else if (items[i].DirectReports?.Count > 0)
-            {
-                RemoveChildRecursive(items[i].DirectReports, item);
-
-                if (items[i].DirectReports.Count == 0)
-                {
-                    items[i].HasChildren = false;
-                }
-            }
-        }
+        // update the local view-model data with the service data
+        await GetTreeListData();
     }
 
     // OnEdit handler
@@ -174,48 +113,6 @@ Editing is cancelled for the first record.
         // if necessary, perform actual data source operation here through your service
     }
 
-    // the following three methods mimic an actual data service that handles the actual data source
-    // you can see about implement error and exception handling, determining suitable return types as per your needs
-
-    async Task<Employee> ServiceMimicInsert(Employee itemToInsert)
-    {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently, we use "new" here
-        Employee insertedItem = new Employee()
-        {
-            // the service assigns an ID, in this sample we use only the view-model data for simplicity,
-            // you should use the actual data and set the properties as necessary (e.g., generate nested fields data and so on)
-            Id = LastId++,
-            Name = itemToInsert.Name,
-            EmailAddress = itemToInsert.EmailAddress,
-            HireDate = itemToInsert.HireDate,
-            HasChildren = itemToInsert.HasChildren,
-            DirectReports = itemToInsert.DirectReports
-        };
-        return await Task.FromResult(insertedItem);
-    }
-
-    async Task<Employee> ServiceMimicUpdate(Employee itemToUpdate)
-    {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        Employee updatedItem = new Employee()
-        {
-            Id = itemToUpdate.Id,
-            Name = itemToUpdate.Name,
-            EmailAddress = itemToUpdate.EmailAddress,
-            HireDate = itemToUpdate.HireDate,
-            HasChildren = itemToUpdate.HasChildren,
-            DirectReports = itemToUpdate.DirectReports
-        };
-        return await Task.FromResult(updatedItem);
-    }
-
-    async Task<bool> ServiceMimicDelete(Employee itemToDelete)
-    {
-        return await Task.FromResult(true);//always successful
-    }
-
 
     // sample model
 
@@ -243,65 +140,152 @@ Editing is cancelled for the first record.
     }
 
     // data generation
-    // used in this example for data generation and assigning an ID to newly inserted items
-    public int LastId { get; set; } = 1;
+
+    async Task GetTreeListData()
+    {
+        Data = await MyService.Read();
+    }
 
     protected override async Task OnInitializedAsync()
     {
-        Data = await GetTreeListData();
+        await GetTreeListData();
     }
 
-    async Task<List<Employee>> GetTreeListData()
+    // the following static class mimics an actual data service that handles the actual data source
+    // replace it with your actual service through the DI, this only mimics how the API can look like and works for this standalone page
+    public static class MyService
     {
-        List<Employee> data = new List<Employee>();
+        private static List<Employee> _data { get; set; } = new List<Employee>();
+        // used in this example for data generation and retrieval for CUD operations on the current view-model data
+        private static int LastId { get; set; } = 1;
 
-        for (int i = 1; i < 15; i++)
+        public static async Task Create(Employee itemToInsert, Employee parentItem)
         {
-            Employee root = new Employee
-            {
-                Id = LastId,
-                Name = $"root: {i}",
-                EmailAddress = $"{i}@example.com",
-                HireDate = DateTime.Now.AddYears(-i),
-                DirectReports = new List<Employee>(),
-                HasChildren = true
-            };
-            data.Add(root);
-            LastId++;
-
-            for (int j = 1; j < 4; j++)
+            InsertItemRecursive(_data, itemToInsert, parentItem);
+        }
+
+        public static async Task<List<Employee>> Read()
+        {
+            if (_data.Count < 1)
             {
-                int currId = LastId;
-                Employee firstLevelChild = new Employee
-                {
-                    Id = currId,
-                    Name = $"first level child {j} of {i}",
-                    EmailAddress = $"{currId}@example.com",
-                    HireDate = DateTime.Now.AddDays(-currId),
-                    DirectReports = new List<Employee>(),
-                    HasChildren = true
-                };
-                root.DirectReports.Add(firstLevelChild);
-                LastId++;
-
-                for (int k = 1; k < 3; k++)
+                for (int i = 1; i < 15; i++)
                 {
-                    int nestedId = LastId;
-                    firstLevelChild.DirectReports.Add(new Employee
+                    Employee root = new Employee
                     {
                         Id = LastId,
-                        Name = $"second level child {k} of {j} and {i}",
-                        EmailAddress = $"{nestedId}@example.com",
-                        HireDate = DateTime.Now.AddMinutes(-nestedId)
-                    }); ;
+                        Name = $"root: {i}",
+                        EmailAddress = $"{i}@example.com",
+                        HireDate = DateTime.Now.AddYears(-i),
+                        DirectReports = new List<Employee>(),
+                        HasChildren = true
+                    };
+                    _data.Add(root);
                     LastId++;
+
+                    for (int j = 1; j < 4; j++)
+                    {
+                        int currId = LastId;
+                        Employee firstLevelChild = new Employee
+                        {
+                            Id = currId,
+                            Name = $"first level child {j} of {i}",
+                            EmailAddress = $"{currId}@example.com",
+                            HireDate = DateTime.Now.AddDays(-currId),
+                            DirectReports = new List<Employee>(),
+                            HasChildren = true
+                        };
+                        root.DirectReports.Add(firstLevelChild);
+                        LastId++;
+
+                        for (int k = 1; k < 3; k++)
+                        {
+                            int nestedId = LastId;
+                            firstLevelChild.DirectReports.Add(new Employee
+                            {
+                                Id = LastId,
+                                Name = $"second level child {k} of {j} and {i}",
+                                EmailAddress = $"{nestedId}@example.com",
+                                HireDate = DateTime.Now.AddMinutes(-nestedId)
+                            }); ;
+                            LastId++;
+                        }
+                    }
+                }
+
+                _data[0].Name += " (non-editable, see OnEdit)";
+            }
+
+            return await Task.FromResult(_data);
+        }
+
+        public static async Task Update(Employee itemToUpdate)
+        {
+            UpdateItemRecursive(_data, itemToUpdate);
+        }
+
+        public static async Task Delete(Employee itemToDelete)
+        {
+            RemoveChildRecursive(_data, itemToDelete);
+        }
+
+        // sample helper methods for handling the view-model data hierarchy
+        static void UpdateItemRecursive(List<Employee> items, Employee itemToUpdate)
+        {
+            for (int i = 0; i < items.Count; i++)
+            {
+                if (items[i].Id.Equals(itemToUpdate.Id))
+                {
+                    items[i] = itemToUpdate;
+                    return;
+                }
+
+                if (items[i].DirectReports?.Count > 0)
+                {
+                    UpdateItemRecursive(items[i].DirectReports, itemToUpdate);
                 }
             }
         }
 
-        data[0].Name += " (non-editable, see OnEdit)";
+        static void RemoveChildRecursive(List<Employee> items, Employee item)
+        {
+            for (int i = 0; i < items.Count(); i++)
+            {
+                if (item.Equals(items[i]))
+                {
+                    items.Remove(item);
+
+                    return;
+                }
+                else if (items[i].DirectReports?.Count > 0)
+                {
+                    RemoveChildRecursive(items[i].DirectReports, item);
 
-        return await Task.FromResult(data);
+                    if (items[i].DirectReports.Count == 0)
+                    {
+                        items[i].HasChildren = false;
+                    }
+                }
+            }
+        }
+
+        static void InsertItemRecursive(List<Employee> Data, Employee insertedItem, Employee parentItem)
+        {
+            insertedItem.Id = LastId++;
+            if (parentItem != null)
+            {
+                parentItem.HasChildren = true;
+                if (parentItem.DirectReports == null)
+                {
+                    parentItem.DirectReports = new List<Employee>();
+                }
+
+                parentItem.DirectReports.Insert(0, insertedItem);
+            }
+            else
+            {
+                Data.Insert(0, insertedItem);
+            }
+        }
     }
 }
 ````

From 93b9c049b5d514f677a7b8b29a1aca089eed04ae Mon Sep 17 00:00:00 2001
From: Marin Bratanov <m.bratanov@gmail.com>
Date: Sat, 7 Nov 2020 20:08:10 +0200
Subject: [PATCH 18/22] chore(treeList): popup editing better CRUD mimic

---
 components/treelist/editing/popup.md | 295 +++++++++++++--------------
 1 file changed, 139 insertions(+), 156 deletions(-)

diff --git a/components/treelist/editing/popup.md b/components/treelist/editing/popup.md
index 391e188c25..15bab0fe9c 100644
--- a/components/treelist/editing/popup.md
+++ b/components/treelist/editing/popup.md
@@ -58,6 +58,7 @@ Editing is cancelled for the first record.
     </TreeListColumns>
 </TelerikTreeList>
 
+
 @code {
     public List<Employee> Data { get; set; }
 
@@ -67,21 +68,22 @@ Editing is cancelled for the first record.
         var item = args.Item as Employee;
 
         // perform actual data source operations here through your service
-        Employee updatedItem = await ServiceMimicUpdate(item);
+        await MyService.Update(item);
 
         // update the local view-model data with the service data
-        UpdateItemRecursive(Data, updatedItem);
+        await GetTreeListData();
     }
 
     async Task CreateItem(TreeListCommandEventArgs args)
     {
-        var argsItem = args.Item as Employee;
+        var item = args.Item as Employee;
+        var parentItem = args.ParentItem as Employee;
 
-        // perform actual data source operation here through your service
-        Employee insertedItem = await ServiceMimicInsert(argsItem);
+        // perform actual data source operations here through your service
+        await MyService.Create(item, parentItem);
 
         // update the local view-model data with the service data
-        InsertItemRecursive(Data, insertedItem, args);
+        await GetTreeListData();
     }
 
     async Task DeleteItem(TreeListCommandEventArgs args)
@@ -89,73 +91,10 @@ Editing is cancelled for the first record.
         var item = args.Item as Employee;
 
         // perform actual data source operations here through your service
-        bool isDeleted = await ServiceMimicDelete(item);
-
-        if (isDeleted)
-        {
-            // update the local view-model data
-            RemoveChildRecursive(Data, item);
-        }
-    }
-
-    // sample helper methods for handling the view-model data hierarchy
-    void InsertItemRecursive(List<Employee> Data, Employee insertedItem, TreeListCommandEventArgs args)
-    {
-        if (args.ParentItem != null)
-        {
-            var parent = (Employee)args.ParentItem;
-
-            parent.HasChildren = true;
-            if (parent.DirectReports == null)
-            {
-                parent.DirectReports = new List<Employee>();
-            }
+        await MyService.Delete(item);
 
-            parent.DirectReports.Insert(0, insertedItem);
-        }
-        else
-        {
-            Data.Insert(0, insertedItem);
-        }
-    }
-
-    void UpdateItemRecursive(List<Employee> items, Employee itemToUpdate)
-    {
-        for (int i = 0; i < items.Count; i++)
-        {
-            if (items[i].Id.Equals(itemToUpdate.Id))
-            {
-                items[i] = itemToUpdate;
-                return;
-            }
-
-            if (items[i].DirectReports?.Count > 0)
-            {
-                UpdateItemRecursive(items[i].DirectReports, itemToUpdate);
-            }
-        }
-    }
-
-    void RemoveChildRecursive(List<Employee> items, Employee item)
-    {
-        for (int i = 0; i < items.Count(); i++)
-        {
-            if (item.Equals(items[i]))
-            {
-                items.Remove(item);
-
-                return;
-            }
-            else if (items[i].DirectReports?.Count > 0)
-            {
-                RemoveChildRecursive(items[i].DirectReports, item);
-
-                if (items[i].DirectReports.Count == 0)
-                {
-                    items[i].HasChildren = false;
-                }
-            }
-        }
+        // update the local view-model data with the service data
+        await GetTreeListData();
     }
 
     // OnEdit handler
@@ -180,49 +119,6 @@ Editing is cancelled for the first record.
     }
 
 
-    // the following three methods mimic an actual data service that handles the actual data source
-    // you can see about implement error and exception handling, determining suitable return types as per your needs
-
-    async Task<Employee> ServiceMimicInsert(Employee itemToInsert)
-    {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently, we use "new" here
-        Employee insertedItem = new Employee()
-        {
-            // the service assigns an ID, in this sample we use only the view-model data for simplicity,
-            // you should use the actual data and set the properties as necessary (e.g., generate nested fields data and so on)
-            Id = LastId++,
-            Name = itemToInsert.Name,
-            EmailAddress = itemToInsert.EmailAddress,
-            HireDate = itemToInsert.HireDate,
-            HasChildren = itemToInsert.HasChildren,
-            DirectReports = itemToInsert.DirectReports
-        };
-        return await Task.FromResult(insertedItem);
-    }
-
-    async Task<Employee> ServiceMimicUpdate(Employee itemToUpdate)
-    {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        Employee updatedItem = new Employee()
-        {
-            Id = itemToUpdate.Id,
-            Name = itemToUpdate.Name,
-            EmailAddress = itemToUpdate.EmailAddress,
-            HireDate = itemToUpdate.HireDate,
-            HasChildren = itemToUpdate.HasChildren,
-            DirectReports = itemToUpdate.DirectReports
-        };
-        return await Task.FromResult(updatedItem);
-    }
-
-    async Task<bool> ServiceMimicDelete(Employee itemToDelete)
-    {
-        return await Task.FromResult(true);//always successful
-    }
-
-
     // sample model
 
     public class Employee
@@ -252,65 +148,152 @@ Editing is cancelled for the first record.
     }
 
     // data generation
-    // used in this example for data generation and assigning an ID to newly inserted items
-    public int LastId { get; set; } = 1;
+
+    async Task GetTreeListData()
+    {
+        Data = await MyService.Read();
+    }
 
     protected override async Task OnInitializedAsync()
     {
-        Data = await GetTreeListData();
+        await GetTreeListData();
     }
 
-    async Task<List<Employee>> GetTreeListData()
+    // the following static class mimics an actual data service that handles the actual data source
+    // replace it with your actual service through the DI, this only mimics how the API can look like and works for this standalone page
+    public static class MyService
     {
-        List<Employee> data = new List<Employee>();
+        private static List<Employee> _data { get; set; } = new List<Employee>();
+        // used in this example for data generation and retrieval for CUD operations on the current view-model data
+        private static int LastId { get; set; } = 1;
 
-        for (int i = 1; i < 15; i++)
+        public static async Task Create(Employee itemToInsert, Employee parentItem)
         {
-            Employee root = new Employee
-            {
-                Id = LastId,
-                Name = $"root: {i}",
-                EmailAddress = $"{i}@example.com",
-                HireDate = DateTime.Now.AddYears(-i),
-                DirectReports = new List<Employee>(),
-                HasChildren = true
-            };
-            data.Add(root);
-            LastId++;
-
-            for (int j = 1; j < 4; j++)
+            InsertItemRecursive(_data, itemToInsert, parentItem);
+        }
+
+        public static async Task<List<Employee>> Read()
+        {
+            if (_data.Count < 1)
             {
-                int currId = LastId;
-                Employee firstLevelChild = new Employee
-                {
-                    Id = currId,
-                    Name = $"first level child {j} of {i}",
-                    EmailAddress = $"{currId}@example.com",
-                    HireDate = DateTime.Now.AddDays(-currId),
-                    DirectReports = new List<Employee>(),
-                    HasChildren = true
-                };
-                root.DirectReports.Add(firstLevelChild);
-                LastId++;
-
-                for (int k = 1; k < 3; k++)
+                for (int i = 1; i < 15; i++)
                 {
-                    int nestedId = LastId;
-                    firstLevelChild.DirectReports.Add(new Employee
+                    Employee root = new Employee
                     {
                         Id = LastId,
-                        Name = $"second level child {k} of {j} and {i}",
-                        EmailAddress = $"{nestedId}@example.com",
-                        HireDate = DateTime.Now.AddMinutes(-nestedId)
-                    }); ;
+                        Name = $"root: {i}",
+                        EmailAddress = $"{i}@example.com",
+                        HireDate = DateTime.Now.AddYears(-i),
+                        DirectReports = new List<Employee>(),
+                        HasChildren = true
+                    };
+                    _data.Add(root);
                     LastId++;
+
+                    for (int j = 1; j < 4; j++)
+                    {
+                        int currId = LastId;
+                        Employee firstLevelChild = new Employee
+                        {
+                            Id = currId,
+                            Name = $"first level child {j} of {i}",
+                            EmailAddress = $"{currId}@example.com",
+                            HireDate = DateTime.Now.AddDays(-currId),
+                            DirectReports = new List<Employee>(),
+                            HasChildren = true
+                        };
+                        root.DirectReports.Add(firstLevelChild);
+                        LastId++;
+
+                        for (int k = 1; k < 3; k++)
+                        {
+                            int nestedId = LastId;
+                            firstLevelChild.DirectReports.Add(new Employee
+                            {
+                                Id = LastId,
+                                Name = $"second level child {k} of {j} and {i}",
+                                EmailAddress = $"{nestedId}@example.com",
+                                HireDate = DateTime.Now.AddMinutes(-nestedId)
+                            }); ;
+                            LastId++;
+                        }
+                    }
+                }
+
+                _data[0].Name += " (non-editable, see OnEdit)";
+            }
+
+            return await Task.FromResult(_data);
+        }
+
+        public static async Task Update(Employee itemToUpdate)
+        {
+            UpdateItemRecursive(_data, itemToUpdate);
+        }
+
+        public static async Task Delete(Employee itemToDelete)
+        {
+            RemoveChildRecursive(_data, itemToDelete);
+        }
+
+        // sample helper methods for handling the view-model data hierarchy
+        static void UpdateItemRecursive(List<Employee> items, Employee itemToUpdate)
+        {
+            for (int i = 0; i < items.Count; i++)
+            {
+                if (items[i].Id.Equals(itemToUpdate.Id))
+                {
+                    items[i] = itemToUpdate;
+                    return;
+                }
+
+                if (items[i].DirectReports?.Count > 0)
+                {
+                    UpdateItemRecursive(items[i].DirectReports, itemToUpdate);
                 }
             }
         }
 
-        data[0].Name += " (non-editable, see OnEdit)";
+        static void RemoveChildRecursive(List<Employee> items, Employee item)
+        {
+            for (int i = 0; i < items.Count(); i++)
+            {
+                if (item.Equals(items[i]))
+                {
+                    items.Remove(item);
+
+                    return;
+                }
+                else if (items[i].DirectReports?.Count > 0)
+                {
+                    RemoveChildRecursive(items[i].DirectReports, item);
 
-        return await Task.FromResult(data);
+                    if (items[i].DirectReports.Count == 0)
+                    {
+                        items[i].HasChildren = false;
+                    }
+                }
+            }
+        }
+
+        static void InsertItemRecursive(List<Employee> Data, Employee insertedItem, Employee parentItem)
+        {
+            insertedItem.Id = LastId++;
+            if (parentItem != null)
+            {
+                parentItem.HasChildren = true;
+                if (parentItem.DirectReports == null)
+                {
+                    parentItem.DirectReports = new List<Employee>();
+                }
+
+                parentItem.DirectReports.Insert(0, insertedItem);
+            }
+            else
+            {
+                Data.Insert(0, insertedItem);
+            }
+        }
     }
 }
 ````

From 01dbe5c5dbc1b0d4c74b56e3bcbfab92ba03a460 Mon Sep 17 00:00:00 2001
From: Marin Bratanov <m.bratanov@gmail.com>
Date: Sat, 7 Nov 2020 20:11:50 +0200
Subject: [PATCH 19/22] chore(treeList): editing overview better CRUD mimic

---
 components/treelist/editing/overview.md | 300 +++++++++++-------------
 1 file changed, 143 insertions(+), 157 deletions(-)

diff --git a/components/treelist/editing/overview.md b/components/treelist/editing/overview.md
index 76f6b25098..ed703465f6 100644
--- a/components/treelist/editing/overview.md
+++ b/components/treelist/editing/overview.md
@@ -53,6 +53,9 @@ The example below shows how you can handle the events the treelist exposes, so y
 >caption Handling the CRUD events of the treelist to save data to the actual data source
 
 ````CSHTML
+@using System.ComponentModel.DataAnnotations
+@* Used for the model annotations only *@
+
 Editing is cancelled for the first record.
 <br />
 
@@ -96,23 +99,24 @@ Editing is cancelled for the first record.
         var item = args.Item as Employee;
 
         // perform actual data source operations here through your service
-        Employee updatedItem = await ServiceMimicUpdate(item);
+        await MyService.Update(item);
 
         // update the local view-model data with the service data
-        UpdateItemRecursive(Data, updatedItem);
+        await GetTreeListData();
 
         AppendToLog("Update", args);
     }
 
     async Task CreateItem(TreeListCommandEventArgs args)
     {
-        var argsItem = args.Item as Employee;
+        var item = args.Item as Employee;
+        var parentItem = args.ParentItem as Employee;
 
-        // perform actual data source operation here through your service
-        Employee insertedItem = await ServiceMimicInsert(argsItem);
+        // perform actual data source operations here through your service
+        await MyService.Create(item, parentItem);
 
         // update the local view-model data with the service data
-        InsertItemRecursive(Data, insertedItem, args);
+        await GetTreeListData();
 
         AppendToLog("Create", args);
     }
@@ -122,78 +126,14 @@ Editing is cancelled for the first record.
         var item = args.Item as Employee;
 
         // perform actual data source operations here through your service
-        bool isDeleted = await ServiceMimicDelete(item);
+        await MyService.Delete(item);
 
-        if (isDeleted)
-        {
-            // update the local view-model data
-            RemoveChildRecursive(Data, item);
-        }
+        // update the local view-model data with the service data
+        await GetTreeListData();
 
         AppendToLog("Delete", args);
     }
 
-
-    // sample helper methods for handling the view-model data hierarchy
-    void InsertItemRecursive(List<Employee> Data, Employee insertedItem, TreeListCommandEventArgs args)
-    {
-        if (args.ParentItem != null)
-        {
-            var parent = (Employee)args.ParentItem;
-
-            parent.HasChildren = true;
-            if (parent.DirectReports == null)
-            {
-                parent.DirectReports = new List<Employee>();
-            }
-
-            parent.DirectReports.Insert(0, insertedItem);
-        }
-        else
-        {
-            Data.Insert(0, insertedItem);
-        }
-    }
-
-    void UpdateItemRecursive(List<Employee> items, Employee itemToUpdate)
-    {
-        for (int i = 0; i < items.Count; i++)
-        {
-            if (items[i].Id.Equals(itemToUpdate.Id))
-            {
-                items[i] = itemToUpdate;
-                return;
-            }
-
-            if (items[i].DirectReports?.Count > 0)
-            {
-                UpdateItemRecursive(items[i].DirectReports, itemToUpdate);
-            }
-        }
-    }
-
-    void RemoveChildRecursive(List<Employee> items, Employee item)
-    {
-        for (int i = 0; i < items.Count(); i++)
-        {
-            if (item.Equals(items[i]))
-            {
-                items.Remove(item);
-
-                return;
-            }
-            else if (items[i].DirectReports?.Count > 0)
-            {
-                RemoveChildRecursive(items[i].DirectReports, item);
-
-                if (items[i].DirectReports.Count == 0)
-                {
-                    items[i].HasChildren = false;
-                }
-            }
-        }
-    }
-
     // OnEdit handler
 
     async Task OnEditHandler(TreeListCommandEventArgs args)
@@ -219,49 +159,6 @@ Editing is cancelled for the first record.
         AppendToLog("Cancel", args);
     }
 
-    // the following three methods mimic an actual data service that handles the actual data source
-    // you can see about implement error and exception handling, determining suitable return types as per your needs
-
-    async Task<Employee> ServiceMimicInsert(Employee itemToInsert)
-    {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently, we use "new" here
-        Employee insertedItem = new Employee()
-        {
-            // the service assigns an ID, in this sample we use only the view-model data for simplicity,
-            // you should use the actual data and set the properties as necessary (e.g., generate nested fields data and so on)
-            Id = LastId++,
-            Name = itemToInsert.Name,
-            EmailAddress = itemToInsert.EmailAddress,
-            HireDate = itemToInsert.HireDate,
-            HasChildren = itemToInsert.HasChildren,
-            DirectReports = itemToInsert.DirectReports
-        };
-        return await Task.FromResult(insertedItem);
-    }
-
-    async Task<Employee> ServiceMimicUpdate(Employee itemToUpdate)
-    {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        Employee updatedItem = new Employee()
-        {
-            Id = itemToUpdate.Id,
-            Name = itemToUpdate.Name,
-            EmailAddress = itemToUpdate.EmailAddress,
-            HireDate = itemToUpdate.HireDate,
-            HasChildren = itemToUpdate.HasChildren,
-            DirectReports = itemToUpdate.DirectReports
-        };
-        return await Task.FromResult(updatedItem);
-    }
-
-    async Task<bool> ServiceMimicDelete(Employee itemToDelete)
-    {
-        return await Task.FromResult(true);//always successful
-    }
-
-
     // sample visualization of the results
     MarkupString logger;
     void AppendToLog(string commandName, TreeListCommandEventArgs args)
@@ -275,11 +172,13 @@ Editing is cancelled for the first record.
         logger = new MarkupString(logger + currAction);
     }
 
+
     // sample model
 
     public class Employee
     {
         public int Id { get; set; }
+
         public string Name { get; set; }
         public string EmailAddress { get; set; }
         public DateTime HireDate { get; set; }
@@ -301,65 +200,152 @@ Editing is cancelled for the first record.
     }
 
     // data generation
-    // used in this example for data generation and assigning an ID to newly inserted items
-    public int LastId { get; set; } = 1;
+
+    async Task GetTreeListData()
+    {
+        Data = await MyService.Read();
+    }
 
     protected override async Task OnInitializedAsync()
     {
-        Data = await GetTreeListData();
+        await GetTreeListData();
     }
 
-    async Task<List<Employee>> GetTreeListData()
+    // the following static class mimics an actual data service that handles the actual data source
+    // replace it with your actual service through the DI, this only mimics how the API can look like and works for this standalone page
+    public static class MyService
     {
-        List<Employee> data = new List<Employee>();
+        private static List<Employee> _data { get; set; } = new List<Employee>();
+        // used in this example for data generation and retrieval for CUD operations on the current view-model data
+        private static int LastId { get; set; } = 1;
 
-        for (int i = 1; i < 15; i++)
+        public static async Task Create(Employee itemToInsert, Employee parentItem)
         {
-            Employee root = new Employee
-            {
-                Id = LastId,
-                Name = $"root: {i}",
-                EmailAddress = $"{i}@example.com",
-                HireDate = DateTime.Now.AddYears(-i),
-                DirectReports = new List<Employee>(),
-                HasChildren = true
-            };
-            data.Add(root);
-            LastId++;
-
-            for (int j = 1; j < 4; j++)
+            InsertItemRecursive(_data, itemToInsert, parentItem);
+        }
+
+        public static async Task<List<Employee>> Read()
+        {
+            if (_data.Count < 1)
             {
-                int currId = LastId;
-                Employee firstLevelChild = new Employee
-                {
-                    Id = currId,
-                    Name = $"first level child {j} of {i}",
-                    EmailAddress = $"{currId}@example.com",
-                    HireDate = DateTime.Now.AddDays(-currId),
-                    DirectReports = new List<Employee>(),
-                    HasChildren = true
-                };
-                root.DirectReports.Add(firstLevelChild);
-                LastId++;
-
-                for (int k = 1; k < 3; k++)
+                for (int i = 1; i < 15; i++)
                 {
-                    int nestedId = LastId;
-                    firstLevelChild.DirectReports.Add(new Employee
+                    Employee root = new Employee
                     {
                         Id = LastId,
-                        Name = $"second level child {k} of {j} and {i}",
-                        EmailAddress = $"{nestedId}@example.com",
-                        HireDate = DateTime.Now.AddMinutes(-nestedId)
-                    }); ;
+                        Name = $"root: {i}",
+                        EmailAddress = $"{i}@example.com",
+                        HireDate = DateTime.Now.AddYears(-i),
+                        DirectReports = new List<Employee>(),
+                        HasChildren = true
+                    };
+                    _data.Add(root);
                     LastId++;
+
+                    for (int j = 1; j < 4; j++)
+                    {
+                        int currId = LastId;
+                        Employee firstLevelChild = new Employee
+                        {
+                            Id = currId,
+                            Name = $"first level child {j} of {i}",
+                            EmailAddress = $"{currId}@example.com",
+                            HireDate = DateTime.Now.AddDays(-currId),
+                            DirectReports = new List<Employee>(),
+                            HasChildren = true
+                        };
+                        root.DirectReports.Add(firstLevelChild);
+                        LastId++;
+
+                        for (int k = 1; k < 3; k++)
+                        {
+                            int nestedId = LastId;
+                            firstLevelChild.DirectReports.Add(new Employee
+                            {
+                                Id = LastId,
+                                Name = $"second level child {k} of {j} and {i}",
+                                EmailAddress = $"{nestedId}@example.com",
+                                HireDate = DateTime.Now.AddMinutes(-nestedId)
+                            }); ;
+                            LastId++;
+                        }
+                    }
+                }
+
+                _data[0].Name += " (non-editable, see OnEdit)";
+            }
+
+            return await Task.FromResult(_data);
+        }
+
+        public static async Task Update(Employee itemToUpdate)
+        {
+            UpdateItemRecursive(_data, itemToUpdate);
+        }
+
+        public static async Task Delete(Employee itemToDelete)
+        {
+            RemoveChildRecursive(_data, itemToDelete);
+        }
+
+        // sample helper methods for handling the view-model data hierarchy
+        static void UpdateItemRecursive(List<Employee> items, Employee itemToUpdate)
+        {
+            for (int i = 0; i < items.Count; i++)
+            {
+                if (items[i].Id.Equals(itemToUpdate.Id))
+                {
+                    items[i] = itemToUpdate;
+                    return;
+                }
+
+                if (items[i].DirectReports?.Count > 0)
+                {
+                    UpdateItemRecursive(items[i].DirectReports, itemToUpdate);
+                }
+            }
+        }
+
+        static void RemoveChildRecursive(List<Employee> items, Employee item)
+        {
+            for (int i = 0; i < items.Count(); i++)
+            {
+                if (item.Equals(items[i]))
+                {
+                    items.Remove(item);
+
+                    return;
+                }
+                else if (items[i].DirectReports?.Count > 0)
+                {
+                    RemoveChildRecursive(items[i].DirectReports, item);
+
+                    if (items[i].DirectReports.Count == 0)
+                    {
+                        items[i].HasChildren = false;
+                    }
                 }
             }
         }
 
-        data[0].Name += " (non-editable, see OnEdit)";
+        static void InsertItemRecursive(List<Employee> Data, Employee insertedItem, Employee parentItem)
+        {
+            insertedItem.Id = LastId++;
+            if (parentItem != null)
+            {
+                parentItem.HasChildren = true;
+                if (parentItem.DirectReports == null)
+                {
+                    parentItem.DirectReports = new List<Employee>();
+                }
 
-        return await Task.FromResult(data);
+                parentItem.DirectReports.Insert(0, insertedItem);
+            }
+            else
+            {
+                Data.Insert(0, insertedItem);
+            }
+        }
     }
 }
 ````

From fffabf22e398de0c6881eda36daf8eb9fa159d9f Mon Sep 17 00:00:00 2001
From: Marin Bratanov <m.bratanov@gmail.com>
Date: Sat, 7 Nov 2020 20:18:09 +0200
Subject: [PATCH 20/22] docs(treelist): improvements on editing notes

---
 components/treelist/editing/overview.md | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/components/treelist/editing/overview.md b/components/treelist/editing/overview.md
index ed703465f6..75854b52a2 100644
--- a/components/treelist/editing/overview.md
+++ b/components/treelist/editing/overview.md
@@ -356,12 +356,11 @@ There are a few considerations to keep in mind with the CUD operations of the tr
 
 * It is up to the data access logic to save the data once it is changed in the data collection. The example above showcases when that happens and adds some code to provide a visual indication of the change. In a real application, the code for handling data updates may be entirely different.
 
-* The CRUD event handlers must be `async Task` and **not** `async void`. A Task can be properly awaited and allows working with services and contexts. When the method returns `void`, the execution of the context operations is not actually awaited, and you may get errors from the context (such as "Cannot access a disposed object. A common cause of this error is disposing a context that was resolved from dependency injection and then later trying to use the same context instance elsewhere in your application" or "A second operation started on this context before a previous operation completed. This is usually caused by different threads using the same instance of DbContext").
+* The CRUD event handlers must be `async Task` and **not** `async void`. A Task can be properly awaited and allows working with services and contexts, and lets the treelist update after the actual data source operations complete.
 
-* The treelist uses `Activator.CreateInstance<TItem>();` to generate a new item when an Insert action is invoked, so the Model should have a Parameterless constructor defined. 
+    * When the method returns `void`, the execution of the context operations is not actually awaited, and you may get errors from the context (such as "Cannot access a disposed object. A common cause of this error is disposing a context that was resolved from dependency injection and then later trying to use the same context instance elsewhere in your application" or "A second operation started on this context before a previous operation completed. This is usually caused by different threads using the same instance of DbContext"). The treelist may also re-render before the actual data update happens and you may not see the result.
 
-<!-- A workaround might be [invoking Insert through the treelist state]({                    %slug treelist-state%}#initiate-editing-or-inserting-of-an-item) and creating the object with your own code.
--->
+* The treelist uses `Activator.CreateInstance<TItem>();` to generate a new item when an Insert action is invoked, so the Model should have a Parameterless constructor defined. A workaround might be [invoking Insert through the treelist state]({%slug treelist-state%}#initiate-editing-or-inserting-of-an-item) and creating the object with your own code.
 
 ## See Also
 

From 04afa4cc5f6d4dbe6edcb9dbd8f634f630a7254d Mon Sep 17 00:00:00 2001
From: Marin Bratanov <m.bratanov@gmail.com>
Date: Sat, 7 Nov 2020 20:26:11 +0200
Subject: [PATCH 21/22] chore(treeList): state sampel better CRUD mimic

---
 components/treelist/state.md | 316 +++++++++++++++++------------------
 1 file changed, 149 insertions(+), 167 deletions(-)

diff --git a/components/treelist/state.md b/components/treelist/state.md
index e509d86ae9..9b87620b6e 100644
--- a/components/treelist/state.md
+++ b/components/treelist/state.md
@@ -662,6 +662,7 @@ In addition to that, you can also use the `EditItem`, `OriginalEditItem`, `Inser
 </TelerikTreeList>
 
 @code {
+    public List<Employee> Data { get; set; }
     TelerikTreeList<Employee> TreeListRef { get; set; } = new TelerikTreeList<Employee>();
 
     async Task EnterEditMode()
@@ -688,48 +689,8 @@ In addition to that, you can also use the `EditItem`, `OriginalEditItem`, `Inser
         await TreeListRef.SetState(state);
     }
 
-    public List<Employee> Data { get; set; }
-
-    // Sample CUD operations for the local data
-    async Task UpdateItem(TreeListCommandEventArgs args)
-    {
-        var item = args.Item as Employee;
-
-        // perform actual data source operations here through your service
-        Employee updatedItem = await ServiceMimicUpdate(item);
-
-        // update the local view-model data with the service data
-        UpdateItemRecursive(Data, updatedItem);
-    }
-
-    async Task CreateItem(TreeListCommandEventArgs args)
-    {
-        var argsItem = args.Item as Employee;
-
-        // perform actual data source operation here through your service
-        Employee insertedItem = await ServiceMimicInsert(argsItem);
-
-        // update the local view-model data with the service data
-        InsertItemRecursive(Data, insertedItem, args);
-    }
-
-    async Task DeleteItem(TreeListCommandEventArgs args)
-    {
-        var item = args.Item as Employee;
-
-        // perform actual data source operations here through your service
-        bool isDeleted = await ServiceMimicDelete(item);
-
-        if (isDeleted)
-        {
-            // update the local view-model data
-            RemoveChildRecursive(Data, item);
-        }
-    }
-
-
-    // sample helper methods for handling the view-model data hierarchy
-    private Employee FindItemRecursive(List<Employee> items, int id)
+    // sample helper method for handling the view-model data hierarchy
+    Employee FindItemRecursive(List<Employee> items, int id)
     {
         foreach (var item in items)
         {
@@ -752,108 +713,42 @@ In addition to that, you can also use the `EditItem`, `OriginalEditItem`, `Inser
         return null;
     }
 
-    void InsertItemRecursive(List<Employee> Data, Employee insertedItem, TreeListCommandEventArgs args)
+    // Sample CUD operations for the local data
+    async Task UpdateItem(TreeListCommandEventArgs args)
     {
-        if (args.ParentItem != null)
-        {
-            var parent = (Employee)args.ParentItem;
-
-            parent.HasChildren = true;
-            if (parent.DirectReports == null)
-            {
-                parent.DirectReports = new List<Employee>();
-            }
-
-            parent.DirectReports.Insert(0, insertedItem);
-        }
-        else
-        {
-            Data.Insert(0, insertedItem);
-        }
-    }
+        var item = args.Item as Employee;
 
-    void UpdateItemRecursive(List<Employee> items, Employee itemToUpdate)
-    {
-        for (int i = 0; i < items.Count; i++)
-        {
-            if (items[i].Id.Equals(itemToUpdate.Id))
-            {
-                items[i] = itemToUpdate;
-                return;
-            }
+        // perform actual data source operations here through your service
+        await MyService.Update(item);
 
-            if (items[i].DirectReports?.Count > 0)
-            {
-                UpdateItemRecursive(items[i].DirectReports, itemToUpdate);
-            }
-        }
+        // update the local view-model data with the service data
+        await GetTreeListData();
     }
 
-    void RemoveChildRecursive(List<Employee> items, Employee item)
+    async Task CreateItem(TreeListCommandEventArgs args)
     {
-        for (int i = 0; i < items.Count(); i++)
-        {
-            if (item.Equals(items[i]))
-            {
-                items.Remove(item);
+        var item = args.Item as Employee;
+        var parentItem = args.ParentItem as Employee;
 
-                return;
-            }
-            else if (items[i].DirectReports?.Count > 0)
-            {
-                RemoveChildRecursive(items[i].DirectReports, item);
+        // perform actual data source operations here through your service
+        await MyService.Create(item, parentItem);
 
-                if (items[i].DirectReports.Count == 0)
-                {
-                    items[i].HasChildren = false;
-                }
-            }
-        }
+        // update the local view-model data with the service data
+        await GetTreeListData();
     }
 
-
-    // the following three methods mimic an actual data service that handles the actual data source
-    // you can see about implement error and exception handling, determining suitable return types as per your needs
-
-    async Task<Employee> ServiceMimicInsert(Employee itemToInsert)
+    async Task DeleteItem(TreeListCommandEventArgs args)
     {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently, we use "new" here
-        Employee insertedItem = new Employee()
-        {
-            // the service assigns an ID, in this sample we use only the view-model data for simplicity,
-            // you should use the actual data and set the properties as necessary (e.g., generate nested fields data and so on)
-            Id = LastId++,
-            Name = itemToInsert.Name,
-            EmailAddress = itemToInsert.EmailAddress,
-            HireDate = itemToInsert.HireDate,
-            HasChildren = itemToInsert.HasChildren,
-            DirectReports = itemToInsert.DirectReports
-        };
-        return await Task.FromResult(insertedItem);
-    }
+        var item = args.Item as Employee;
 
-    async Task<Employee> ServiceMimicUpdate(Employee itemToUpdate)
-    {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        Employee updatedItem = new Employee()
-        {
-            Id = itemToUpdate.Id,
-            Name = itemToUpdate.Name,
-            EmailAddress = itemToUpdate.EmailAddress,
-            HireDate = itemToUpdate.HireDate,
-            HasChildren = itemToUpdate.HasChildren,
-            DirectReports = itemToUpdate.DirectReports
-        };
-        return await Task.FromResult(updatedItem);
-    }
+        // perform actual data source operations here through your service
+        await MyService.Delete(item);
 
-    async Task<bool> ServiceMimicDelete(Employee itemToDelete)
-    {
-        return await Task.FromResult(true);//always successful
+        // update the local view-model data with the service data
+        await GetTreeListData();
     }
 
+
     // sample model
 
     public class Employee
@@ -908,63 +803,150 @@ In addition to that, you can also use the `EditItem`, `OriginalEditItem`, `Inser
     }
 
     // data generation
-    // used in this example for data generation and assigning an ID to newly inserted items
-    public int LastId { get; set; } = 1;
+
+    async Task GetTreeListData()
+    {
+        Data = await MyService.Read();
+    }
 
     protected override async Task OnInitializedAsync()
     {
-        Data = await GetTreeListData();
+        await GetTreeListData();
     }
 
-    async Task<List<Employee>> GetTreeListData()
+    // the following static class mimics an actual data service that handles the actual data source
+    // replace it with your actual service through the DI, this only mimics how the API can look like and works for this standalone page
+    public static class MyService
     {
-        List<Employee> data = new List<Employee>();
+        private static List<Employee> _data { get; set; } = new List<Employee>();
+        // used in this example for data generation and retrieval for CUD operations on the current view-model data
+        private static int LastId { get; set; } = 1;
 
-        for (int i = 1; i < 15; i++)
+        public static async Task Create(Employee itemToInsert, Employee parentItem)
         {
-            Employee root = new Employee
+            InsertItemRecursive(_data, itemToInsert, parentItem);
+        }
+
+        public static async Task<List<Employee>> Read()
+        {
+            if (_data.Count < 1)
             {
-                Id = LastId,
-                Name = $"root: {i}",
-                EmailAddress = $"{i}@example.com",
-                HireDate = DateTime.Now.AddYears(-i),
-                DirectReports = new List<Employee>(),
-                HasChildren = true
-            };
-            data.Add(root);
-            LastId++;
+                for (int i = 1; i < 15; i++)
+                {
+                    Employee root = new Employee
+                    {
+                        Id = LastId,
+                        Name = $"root: {i}",
+                        EmailAddress = $"{i}@example.com",
+                        HireDate = DateTime.Now.AddYears(-i),
+                        DirectReports = new List<Employee>(),
+                        HasChildren = true
+                    };
+                    _data.Add(root);
+                    LastId++;
 
-            for (int j = 1; j < 4; j++)
+                    for (int j = 1; j < 4; j++)
+                    {
+                        int currId = LastId;
+                        Employee firstLevelChild = new Employee
+                        {
+                            Id = currId,
+                            Name = $"first level child {j} of {i}",
+                            EmailAddress = $"{currId}@example.com",
+                            HireDate = DateTime.Now.AddDays(-currId),
+                            DirectReports = new List<Employee>(),
+                            HasChildren = true
+                        };
+                        root.DirectReports.Add(firstLevelChild);
+                        LastId++;
+
+                        for (int k = 1; k < 3; k++)
+                        {
+                            int nestedId = LastId;
+                            firstLevelChild.DirectReports.Add(new Employee
+                            {
+                                Id = LastId,
+                                Name = $"second level child {k} of {j} and {i}",
+                                EmailAddress = $"{nestedId}@example.com",
+                                HireDate = DateTime.Now.AddMinutes(-nestedId)
+                            }); ;
+                            LastId++;
+                        }
+                    }
+                }
+            }
+
+            return await Task.FromResult(_data);
+        }
+
+        public static async Task Update(Employee itemToUpdate)
+        {
+            UpdateItemRecursive(_data, itemToUpdate);
+        }
+
+        public static async Task Delete(Employee itemToDelete)
+        {
+            RemoveChildRecursive(_data, itemToDelete);
+        }
+
+        // sample helper methods for handling the view-model data hierarchy
+        static void UpdateItemRecursive(List<Employee> items, Employee itemToUpdate)
+        {
+            for (int i = 0; i < items.Count; i++)
             {
-                int currId = LastId;
-                Employee firstLevelChild = new Employee
+                if (items[i].Id.Equals(itemToUpdate.Id))
                 {
-                    Id = currId,
-                    Name = $"first level child {j} of {i}",
-                    EmailAddress = $"{currId}@example.com",
-                    HireDate = DateTime.Now.AddDays(-currId),
-                    DirectReports = new List<Employee>(),
-                    HasChildren = true
-                };
-                root.DirectReports.Add(firstLevelChild);
-                LastId++;
+                    items[i] = itemToUpdate;
+                    return;
+                }
 
-                for (int k = 1; k < 3; k++)
+                if (items[i].DirectReports?.Count > 0)
                 {
-                    int nestedId = LastId;
-                    firstLevelChild.DirectReports.Add(new Employee
+                    UpdateItemRecursive(items[i].DirectReports, itemToUpdate);
+                }
+            }
+        }
+
+        static void RemoveChildRecursive(List<Employee> items, Employee item)
+        {
+            for (int i = 0; i < items.Count(); i++)
+            {
+                if (item.Equals(items[i]))
+                {
+                    items.Remove(item);
+
+                    return;
+                }
+                else if (items[i].DirectReports?.Count > 0)
+                {
+                    RemoveChildRecursive(items[i].DirectReports, item);
+
+                    if (items[i].DirectReports.Count == 0)
                     {
-                        Id = LastId,
-                        Name = $"second level child {k} of {j} and {i}",
-                        EmailAddress = $"{nestedId}@example.com",
-                        HireDate = DateTime.Now.AddMinutes(-nestedId)
-                    }); ;
-                    LastId++;
+                        items[i].HasChildren = false;
+                    }
                 }
             }
         }
 
-        return await Task.FromResult(data);
+        static void InsertItemRecursive(List<Employee> Data, Employee insertedItem, Employee parentItem)
+        {
+            insertedItem.Id = LastId++;
+            if (parentItem != null)
+            {
+                parentItem.HasChildren = true;
+                if (parentItem.DirectReports == null)
+                {
+                    parentItem.DirectReports = new List<Employee>();
+                }
+
+                parentItem.DirectReports.Insert(0, insertedItem);
+            }
+            else
+            {
+                Data.Insert(0, insertedItem);
+            }
+        }
     }
 }
 ````

From 335473f3eb9cfbe22a612e519a76deaf97ab0af6 Mon Sep 17 00:00:00 2001
From: Marin Bratanov <m.bratanov@gmail.com>
Date: Sat, 7 Nov 2020 20:33:18 +0200
Subject: [PATCH 22/22] chore(treeList): editor template better CRUD mimic

---
 components/treelist/templates/editor.md | 178 ++++++++++++------------
 1 file changed, 92 insertions(+), 86 deletions(-)

diff --git a/components/treelist/templates/editor.md b/components/treelist/templates/editor.md
index a1194af66b..1a7a66aeaf 100644
--- a/components/treelist/templates/editor.md
+++ b/components/treelist/templates/editor.md
@@ -53,58 +53,20 @@ If you need to perform logic more complex than simple data binding, use the chan
 </TelerikTreeList>
 
 @code {
-    public List<Employee> Data { get; set; }
-    public static List<string> Roles = new List<string> { "Manager", "Employee", "Contractor" };
-    public Employee CurrentlyEditedEmployee { get; set; }
+    List<Employee> Data { get; set; }
+    static List<string> Roles { get; set; }
+    Employee CurrentlyEditedEmployee { get; set; }
 
     // Sample CUD operations for the local data
     async Task UpdateItem(TreeListCommandEventArgs args)
     {
-        var item = args.Item as Employee; // you can also use the entire model
+        var item = args.Item as Employee;
 
         // perform actual data source operations here through your service
-        Employee updatedItem = await ServiceMimicUpdate(item);
+        await MyService.Update(item);
 
         // update the local view-model data with the service data
-        UpdateItemRecursive(Data, updatedItem);
-    }
-
-
-    // sample helper method for handling the view-model data hierarchy
-    void UpdateItemRecursive(List<Employee> items, Employee itemToUpdate)
-    {
-        for (int i = 0; i < items.Count; i++)
-        {
-            if (items[i].Id.Equals(itemToUpdate.Id))
-            {
-                items[i] = itemToUpdate;
-                return;
-            }
-
-            if (items[i].DirectReports?.Count > 0)
-            {
-                UpdateItemRecursive(items[i].DirectReports, itemToUpdate);
-            }
-        }
-    }
-
-    // the following method mimics an actual data service that handles the actual data source
-    // you can see about implement error and exception handling, determining suitable return types as per your needs
-    async Task<Employee> ServiceMimicUpdate(Employee itemToUpdate)
-    {
-        // in this example, we just populate the fields, you project may use
-        // something else or generate the updated item differently
-        Employee updatedItem = new Employee()
-        {
-            Id = itemToUpdate.Id,
-            Name = itemToUpdate.Name,
-            Role = itemToUpdate.Role,
-            EmailAddress = itemToUpdate.EmailAddress,
-            HireDate = itemToUpdate.HireDate,
-            HasChildren = itemToUpdate.HasChildren,
-            DirectReports = itemToUpdate.DirectReports
-        };
-        return await Task.FromResult(updatedItem);
+        await GetTreeListData();
     }
 
 
@@ -136,64 +98,108 @@ If you need to perform logic more complex than simple data binding, use the chan
 
     // data generation
 
+    async Task GetTreeListData()
+    {
+        Data = await MyService.Read();
+        Roles = await MyService.GetRoles();
+    }
+
     protected override async Task OnInitializedAsync()
     {
-        Data = await GetTreeListData();
+        await GetTreeListData();
     }
 
-    async Task<List<Employee>> GetTreeListData()
+    // the following static class mimics an actual data service that handles the actual data source
+    // replace it with your actual service through the DI, this only mimics how the API can look like and works for this standalone page
+    public static class MyService
     {
-        List<Employee> data = new List<Employee>();
-        int LastId = 1;
+        private static List<Employee> _data { get; set; } = new List<Employee>();
+        private static List<string> Roles = new List<string> { "Manager", "Employee", "Contractor" };
+        // used in this example for data generation and retrieval for CUD operations on the current view-model data
+        private static int LastId { get; set; } = 1;
 
-        for (int i = 1; i < 15; i++)
+        public static async Task<List<string>> GetRoles()
         {
-            Employee root = new Employee
-            {
-                Id = LastId,
-                Name = $"root: {i}",
-                Role = Roles[i % Roles.Count],
-                EmailAddress = $"{i}@example.com",
-                HireDate = DateTime.Now.AddYears(-i),
-                DirectReports = new List<Employee>(),
-                HasChildren = true
-            };
-            data.Add(root);
-            LastId++;
-
-            for (int j = 1; j < 4; j++)
+            return await Task.FromResult(Roles);
+        }
+
+        public static async Task<List<Employee>> Read()
+        {
+            if (_data.Count < 1)
             {
-                int currId = LastId;
-                Employee firstLevelChild = new Employee
+                for (int i = 1; i < 15; i++)
                 {
-                    Id = currId,
-                    Name = $"first level child {j} of {i}",
-                    Role = Roles[j % Roles.Count],
-                    EmailAddress = $"{currId}@example.com",
-                    HireDate = DateTime.Now.AddDays(-currId),
-                    DirectReports = new List<Employee>(),
-                    HasChildren = true
-                };
-                root.DirectReports.Add(firstLevelChild);
-                LastId++;
-
-                for (int k = 1; k < 3; k++)
-                {
-                    int nestedId = LastId;
-                    firstLevelChild.DirectReports.Add(new Employee
+                    Employee root = new Employee
                     {
                         Id = LastId,
-                        Name = $"second level child {k} of {j} and {i}",
-                        Role = Roles[k % Roles.Count],
-                        EmailAddress = $"{nestedId}@example.com",
-                        HireDate = DateTime.Now.AddMinutes(-nestedId)
-                    }); ;
+                        Name = $"root: {i}",
+                        Role = Roles[i % Roles.Count],
+                        EmailAddress = $"{i}@example.com",
+                        HireDate = DateTime.Now.AddYears(-i),
+                        DirectReports = new List<Employee>(),
+                        HasChildren = true
+                    };
+                    _data.Add(root);
                     LastId++;
+
+                    for (int j = 1; j < 4; j++)
+                    {
+                        int currId = LastId;
+                        Employee firstLevelChild = new Employee
+                        {
+                            Id = currId,
+                            Name = $"first level child {j} of {i}",
+                            Role = Roles[j % Roles.Count],
+                            EmailAddress = $"{currId}@example.com",
+                            HireDate = DateTime.Now.AddDays(-currId),
+                            DirectReports = new List<Employee>(),
+                            HasChildren = true
+                        };
+                        root.DirectReports.Add(firstLevelChild);
+                        LastId++;
+
+                        for (int k = 1; k < 3; k++)
+                        {
+                            int nestedId = LastId;
+                            firstLevelChild.DirectReports.Add(new Employee
+                            {
+                                Id = LastId,
+                                Name = $"second level child {k} of {j} and {i}",
+                                Role = Roles[k % Roles.Count],
+                                EmailAddress = $"{nestedId}@example.com",
+                                HireDate = DateTime.Now.AddMinutes(-nestedId)
+                            }); ;
+                            LastId++;
+                        }
+                    }
                 }
             }
+
+            return await Task.FromResult(_data);
+        }
+
+        public static async Task Update(Employee itemToUpdate)
+        {
+            UpdateItemRecursive(_data, itemToUpdate);
         }
 
-        return await Task.FromResult(data);
+        // sample helper methods for handling the view-model data hierarchy
+        static void UpdateItemRecursive(List<Employee> items, Employee itemToUpdate)
+        {
+            for (int i = 0; i < items.Count; i++)
+            {
+                if (items[i].Id.Equals(itemToUpdate.Id))
+                {
+                    items[i] = itemToUpdate;
+                    return;
+                }
+
+                if (items[i].DirectReports?.Count > 0)
+                {
+                    UpdateItemRecursive(items[i].DirectReports, itemToUpdate);
+                }
+            }
+        }
     }
 }
 ````