Update readme

.gitignore

@@ -29,6 +29,7 @@ bld/
 [Bb]in/
 [Oo]bj/
 [Ll]og/
+CSOld/
 
 # Visual Studio 2015/2017 cache/options directory
 .vs/

CS/EFCore/NonPersistentFilteringEF/NonPersistentFilteringEF.Blazor.Server/App.razor

@@ -0,0 +1,11 @@
+<Router AppAssembly="@typeof(Program).Assembly" AdditionalAssemblies="new[] { typeof(DevExpress.ExpressApp.Blazor.BlazorApplication).Assembly }">
+    <Found Context="routeData">
+        <RouteView RouteData="@routeData" />
+    </Found>
+    <NotFound>
+        <LayoutView>
+            <PageTitle>Not found</PageTitle>
+            <p role="alert">Sorry, there's nothing at this address.</p>
+        </LayoutView>
+    </NotFound>
+</Router>

CS/EFCore/NonPersistentFilteringEF/NonPersistentFilteringEF.Blazor.Server/BlazorApplication.cs

@@ -0,0 +1,48 @@
+using DevExpress.ExpressApp;
+using DevExpress.ExpressApp.ApplicationBuilder;
+using DevExpress.ExpressApp.Blazor;
+using DevExpress.ExpressApp.SystemModule;
+using NonPersistentFilteringEF.Module.BusinessObjects;
+using Microsoft.EntityFrameworkCore;
+using DevExpress.ExpressApp.EFCore;
+
+namespace NonPersistentFilteringEF.Blazor.Server;
+
+public class NonPersistentFilteringEFBlazorApplication : BlazorApplication {
+    public NonPersistentFilteringEFBlazorApplication() {
+        ApplicationName = "NonPersistentFilteringEF";
+        CheckCompatibilityType = DevExpress.ExpressApp.CheckCompatibilityType.DatabaseSchema;
+        DatabaseVersionMismatch += NonPersistentFilteringEFBlazorApplication_DatabaseVersionMismatch;
+    }
+    protected override void OnSetupStarted() {
+        base.OnSetupStarted();
+#if DEBUG
+        if(System.Diagnostics.Debugger.IsAttached && CheckCompatibilityType == CheckCompatibilityType.DatabaseSchema) {
+            DatabaseUpdateMode = DatabaseUpdateMode.UpdateDatabaseAlways;
+        }
+#endif
+    }
+    private void NonPersistentFilteringEFBlazorApplication_DatabaseVersionMismatch(object sender, DatabaseVersionMismatchEventArgs e) {
+#if EASYTEST
+        e.Updater.Update();
+        e.Handled = true;
+#else
+        if(System.Diagnostics.Debugger.IsAttached) {
+            e.Updater.Update();
+            e.Handled = true;
+        }
+        else {
+            string message = "The application cannot connect to the specified database, " +
+                "because the database doesn't exist, its version is older " +
+                "than that of the application or its schema does not match " +
+                "the ORM data model structure. To avoid this error, use one " +
+                "of the solutions from the https://www.devexpress.com/kb=T367835 KB Article.";
+
+            if(e.CompatibilityError != null && e.CompatibilityError.Exception != null) {
+                message += "\r\n\r\nInner exception: " + e.CompatibilityError.Exception.Message;
+            }
+            throw new InvalidOperationException(message);
+        }
+#endif
+    }
+}

CS/EFCore/NonPersistentFilteringEF/NonPersistentFilteringEF.Blazor.Server/BlazorModule.cs

@@ -0,0 +1,26 @@
+using System.ComponentModel;
+using DevExpress.ExpressApp;
+using DevExpress.ExpressApp.DC;
+using DevExpress.ExpressApp.Model;
+using DevExpress.ExpressApp.Editors;
+using DevExpress.ExpressApp.Actions;
+using DevExpress.ExpressApp.Updating;
+using DevExpress.ExpressApp.Model.Core;
+using DevExpress.ExpressApp.Model.DomainLogics;
+using DevExpress.ExpressApp.Model.NodeGenerators;
+using DevExpress.Persistent.BaseImpl.EF;
+
+namespace NonPersistentFilteringEF.Blazor.Server;
+
+[ToolboxItemFilter("Xaf.Platform.Blazor")]
+// For more typical usage scenarios, be sure to check out https://docs.devexpress.com/eXpressAppFramework/DevExpress.ExpressApp.ModuleBase.
+public sealed class NonPersistentFilteringEFBlazorModule : ModuleBase {
+    public NonPersistentFilteringEFBlazorModule() {
+    }
+    public override IEnumerable<ModuleUpdater> GetModuleUpdaters(IObjectSpace objectSpace, Version versionFromDB) {
+        return ModuleUpdater.EmptyModuleUpdaters;
+    }
+    public override void Setup(XafApplication application) {
+        base.Setup(application);
+    }
+}

CS/EFCore/NonPersistentFilteringEF/NonPersistentFilteringEF.Blazor.Server/Controllers/ReadMe.txt

@@ -0,0 +1,25 @@
+Folder Description
+
+The "Controllers" project folder is intended for storing Blazor-specific Controller classes
+that can change the default XAF application flow and add new features.
+
+
+Relevant Documentation
+
+Controllers and Actions
+https://docs.devexpress.com/eXpressAppFramework/112623
+
+Implement Custom Controllers
+https://docs.devexpress.com/eXpressAppFramework/112621
+
+Define the Scope of Controllers and Actions
+https://docs.devexpress.com/eXpressAppFramework/113103
+
+Ways to Show a View
+https://docs.devexpress.com/eXpressAppFramework/112803
+
+Ways to Implement Business Logic
+https://docs.devexpress.com/eXpressAppFramework/113710
+
+Debugging, Unit and Functional Testing
+https://docs.devexpress.com/eXpressAppFramework/112572

CS/EFCore/NonPersistentFilteringEF/NonPersistentFilteringEF.Blazor.Server/Editors/ReadMe.txt

@@ -0,0 +1,25 @@
+Folder Description
+
+This project folder is intended for storing custom Blazor List Editors,
+Property Editors and View Items.
+
+
+Relevant Documentation
+
+Using a Custom Control that is not Integrated by Default
+https://docs.devexpress.com/eXpressAppFramework/113610
+
+Ways to Access UI Elements and Their Controls
+https://docs.devexpress.com/eXpressAppFramework/120092
+
+Views
+https://docs.devexpress.com/eXpressAppFramework/112611
+
+List Editors
+https://docs.devexpress.com/eXpressAppFramework/113189
+
+View Items
+https://docs.devexpress.com/eXpressAppFramework/112612
+
+Debugging, Unit and Functional Testing
+https://docs.devexpress.com/eXpressAppFramework/112572

CS/EFCore/NonPersistentFilteringEF/NonPersistentFilteringEF.Blazor.Server/Model.xafml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Application>
+  <NavigationItems NavigationStyle="Accordion">
+  </NavigationItems>
+  <Views DefaultListEditor="DevExpress.ExpressApp.Blazor.Editors.DxGridListEditor">
+  </Views>
+</Application>

CS/EFCore/NonPersistentFilteringEF/NonPersistentFilteringEF.Blazor.Server/NonPersistentFilteringEF.Blazor.Server.csproj

@@ -0,0 +1,26 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+  <PropertyGroup>
+    <TargetFramework>net6.0</TargetFramework>
+    <CheckEolTargetFramework>false</CheckEolTargetFramework>
+    <Deterministic>false</Deterministic>
+    <AssemblyVersion>1.0.*</AssemblyVersion>
+    <FileVersion>1.0.0.0</FileVersion>
+    <Configurations>Debug;Release;EasyTest</Configurations>
+    <ImplicitUsings>enable</ImplicitUsings>
+  </PropertyGroup>
+  <ItemGroup>
+    <None Remove="Model.xafml" />
+  </ItemGroup>
+  <ItemGroup>
+    <Content Include="Model.xafml">
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </Content>
+  </ItemGroup>
+  <ItemGroup>
+    <PackageReference Include="DevExpress.ExpressApp.Blazor" Version="22.2.5" />
+    <PackageReference Include="DevExpress.ExpressApp.CodeAnalysis" Version="22.2.5" />
+  </ItemGroup>
+  <ItemGroup>
+    <ProjectReference Include="..\NonPersistentFilteringEF.Module\NonPersistentFilteringEF.Module.csproj" />
+  </ItemGroup>
+</Project>

CS/EFCore/NonPersistentFilteringEF/NonPersistentFilteringEF.Blazor.Server/Pages/_Host.cshtml

@@ -0,0 +1,55 @@
+@page "/"
+@namespace NonPersistentFilteringEF.Blazor.Server
+@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers
+@using DevExpress.ExpressApp.Blazor.Components
+
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, shrink-to-fit=no" />
+    <meta name="apple-mobile-web-app-capable" content="yes" />
+    <!-- meta name="theme-color" content="#000000" -->
+    <title>NonPersistentFilteringEF</title>
+    <base href="~/" />
+    <component type="typeof(BootstrapThemeLink)" render-mode="Static" />
+</head>
+<body>
+    @{
+        string userAgent = Request.Headers["User-Agent"];
+        bool isIE = userAgent.Contains("MSIE") || userAgent.Contains("Trident");
+    }
+    @if(isIE) {
+        <link href="css/site.css" rel="stylesheet" />
+        <div class="d-flex flex-column justify-content-center align-items-center h-100">
+            <div class="d-flex">
+                <img class="mt-2 mr-4" src="_content/DevExpress.ExpressApp.Blazor/images/Sad.svg" width="60" height="60" />
+                <div>
+                    <div class="h1">Internet Explorer is not supported.</div>
+                    <p style="font-size: 1rem; opacity: 0.75;" class="m-0">NonPersistentFilteringEF cannot be loaded in Internet Explorer.<br>Please use a different browser.</p>
+                </div>
+            </div>
+        </div>
+    }
+    else {
+        <component type="typeof(SplashScreen)" render-mode="Static" param-Caption='"NonPersistentFilteringEF"' param-ImagePath='"images/SplashScreen.svg"' />
+
+        <link href="_content/DevExpress.ExpressApp.Blazor/styles.css" rel="stylesheet" />
+        <link href="css/site.css" rel="stylesheet" />
+        <script src="_content/DevExpress.ExpressApp.Blazor/scripts.js"></script>
+
+        <app class="d-none">
+            <component type="typeof(App)" render-mode="Server" />
+        </app>
+
+        <component type="typeof(AlertsHandler)" render-mode="Server" />
+
+        <div id="blazor-error-ui">
+            <component type="typeof(BlazorError)" render-mode="Static" />
+        </div>
+
+        <script src="_framework/blazor.server.js"></script>
+    }
+</body>
+</html>

CS/EFCore/NonPersistentFilteringEF/NonPersistentFilteringEF.Blazor.Server/Program.cs

@@ -0,0 +1,50 @@
+using System.Reflection;
+using DevExpress.ExpressApp;
+using DevExpress.ExpressApp.Blazor.DesignTime;
+using DevExpress.ExpressApp.Blazor.Services;
+using DevExpress.ExpressApp.Design;
+using DevExpress.ExpressApp.Utils;
+
+namespace NonPersistentFilteringEF.Blazor.Server;
+
+public class Program : IDesignTimeApplicationFactory {
+    private static bool ContainsArgument(string[] args, string argument) {
+        return args.Any(arg => arg.TrimStart('/').TrimStart('-').ToLower() == argument.ToLower());
+    }
+    public static int Main(string[] args) {
+        if(ContainsArgument(args, "help") || ContainsArgument(args, "h")) {
+            Console.WriteLine("Updates the database when its version does not match the application's version.");
+            Console.WriteLine();
+            Console.WriteLine($"    {Assembly.GetExecutingAssembly().GetName().Name}.exe --updateDatabase [--forceUpdate --silent]");
+            Console.WriteLine();
+            Console.WriteLine("--forceUpdate - Marks that the database must be updated whether its version matches the application's version or not.");
+            Console.WriteLine("--silent - Marks that database update proceeds automatically and does not require any interaction with the user.");
+            Console.WriteLine();
+            Console.WriteLine($"Exit codes: 0 - {DBUpdaterStatus.UpdateCompleted}");
+            Console.WriteLine($"            1 - {DBUpdaterStatus.UpdateError}");
+            Console.WriteLine($"            2 - {DBUpdaterStatus.UpdateNotNeeded}");
+        }
+        else {
+            DevExpress.ExpressApp.FrameworkSettings.DefaultSettingsCompatibilityMode = DevExpress.ExpressApp.FrameworkSettingsCompatibilityMode.Latest;
+            IHost host = CreateHostBuilder(args).Build();
+            if(ContainsArgument(args, "updateDatabase")) {
+                using(var serviceScope = host.Services.CreateScope()) {
+                    return serviceScope.ServiceProvider.GetRequiredService<DevExpress.ExpressApp.Utils.IDBUpdater>().Update(ContainsArgument(args, "forceUpdate"), ContainsArgument(args, "silent"));
+                }
+            }
+            else {
+                host.Run();
+            }
+        }
+        return 0;
+    }
+    public static IHostBuilder CreateHostBuilder(string[] args) =>
+        Host.CreateDefaultBuilder(args)
+            .ConfigureWebHostDefaults(webBuilder => {
+                webBuilder.UseStartup<Startup>();
+            });
+    XafApplication IDesignTimeApplicationFactory.Create() {
+        IHostBuilder hostBuilder = CreateHostBuilder(Array.Empty<string>());
+        return DesignTimeApplicationFactoryHelper.Create(hostBuilder);
+    }
+}