Merge branch 'master' of https://github.com/zzzprojects/EntityFramework-Plus

Author: JonathanMagnan

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,25 @@
+### Description
+Describe the issue or proposed feature.
+
+### Exception
+If you are seeing an exception, include the full exceptions details (message and stack trace).
+
+```
+Exception message:
+Stack trace:
+```
+
+### Fiddle or Project
+Create a Fiddle that reproduces the issue: https://dotnetfiddle.net/zB4SGA
+
+Or provide a project/solution that we can run to reproduce the issue.
+- Make sure the project compile
+- Make sure to provide only the code that is required to reproduce the issue, not the whole project
+- You can send private code here: [email protected]
+
+_Note: If you are not able to provide code we can run and that reproduce the issue, we will not be able to fix it either._
+
+### Further technical details
+- EF version:
+- EF Plus version:
+- Database Provider:

docs2/pages/documentations/linq-dynamic.md

@@ -33,6 +33,7 @@ var list = ctx.Where(x => "x > 2").ToList();
 var list = ctx.Where(x => "x > y", new { y = 2 }).ToList();
 
 ```
+{% include component-try-it.html href='https://dotnetfiddle.net/Otm0Aa' %}
 
 ## Order && Select
 
@@ -48,14 +49,11 @@ All LINQ selector and order are supported. Most of them require the "Dynamic" su
 {% include template-example.html %} 
 ```csharp
 
-var list = ctx.SelectDynamic(x => "new { y = x + 1 }").ToList();
-var list = ctx.SelectDynamic(x => "new { y = x + 1 }", new { y = 1 }).ToList();
-var list = new List<int>() { 5, 2, 4, 1, 3 };
-
-var list2 = list.OrderByDynamic(x => "x + 1");
-var list3 = list.OrderByDynamic(x => "x + y", new { y = 1 });
+var list = context.Customers.OrderByDescendingDynamic(x => "x.Name").ToList();
+var list = context.Customers.SelectDynamic(x => "x.Name").ToList();
 
 ```
+{% include component-try-it.html href='https://dotnetfiddle.net/OJjBgK' %}
 
 ## Execute
 
@@ -71,3 +69,4 @@ var list = ctx.Execute<IEnumerable<int>>("Where(x => x > 2)");
 var list3 = ctx.Execute("Where(x => x > y).OrderBy(x => x).ToList()", new { y = 2 });
 
 ```
+{% include component-try-it.html href='https://dotnetfiddle.net/mwTqW7' %}

docs2/pages/documentations/query-cache.md

@@ -25,6 +25,7 @@ var countries1 = ctx.Countries.FromCache().ToList();
 var countries2 = ctx.Countries.FromCache().ToList();
 
 ```
+{% include component-try-it.html href='https://dotnetfiddle.net/nx9A2H' %}
 
 ## EF+ Query Cache
 
@@ -43,6 +44,7 @@ var countries = ctx.Countries.Where(x => x.IsActive).FromCache();
 var states = ctx.States.Where(x => x.IsActive).FromCache(DateTime.Now.AddHours(2));
 
 ```
+{% include component-try-it.html href='https://dotnetfiddle.net/BcScGT' %}
 
 ## EF+ Query Cache Async
 
@@ -77,6 +79,7 @@ var count = ctx.Customers.Count();
 // Oops! All customers are cached instead of customer count.
 var count = ctx.Customers.FromCache().Count();
 ```
+{% include component-try-it.html href='https://dotnetfiddle.net/SOjxeY' %}
 
 **EF+ Query Deferred** has been created to resolve this issue, the resolution is now deferred instead of being immediate which lets us cache the expected result.
 
@@ -89,6 +92,7 @@ var ctx = new EntitiesContext();
 var count = ctx.Customers.DeferredCount().FromCache();
 
 ```
+{% include component-try-it.html href='https://dotnetfiddle.net/4MUlef' %}
 
 Query Deferred supports all Queryable extension methods and overloads.
 
@@ -113,6 +117,7 @@ QueryCacheManager.ExpireTag("countries");
 :bulb: Use Enum instead of hard-coding string for tag name.
 
 ```
+{% include component-try-it.html href='https://dotnetfiddle.net/RScINk' %}
 
 ## EF+ Query Cache Expiration
 
@@ -134,6 +139,7 @@ var options = new MemoryCacheEntryOptions() { SlidingExpiration = TimeSpan.FromH
 var states = ctx.States.FromCache(options);
 
 ```
+{% include component-try-it.html href='https://dotnetfiddle.net/f57ZoI' %}
 
 ## EF Query Cache Control
 
@@ -151,6 +157,7 @@ QueryCacheManager.Cache = MemoryCache.Default;
 QueryCacheManager.Cache = new MemoryCache(new MemoryCacheOptions());
 
 ```
+{% include component-try-it.html href='https://dotnetfiddle.net/mIhcff' %}
 
 You can set default policy
 
@@ -166,6 +173,7 @@ var options = new MemoryCacheEntryOptions() { SlidingExpiration = TimeSpan.FromH
 QueryCacheManager.DefaultMemoryCacheEntryOptions = options;
 
 ```
+{% include component-try-it.html href='https://dotnetfiddle.net/7JptcT' %}
 
 ## Real Life Scenarios
 

docs2/pages/documentations/query-db-set-filter.md

@@ -41,6 +41,7 @@ QueryDbSetFilterManager.InitilizeGlobalFilter(ctx);
 var list = ctx.Customers.ToList();
 
 ```
+{% include component-try-it.html href='https://dotnetfiddle.net/HijoZX' %}
 
 ***Use entities context constructor to initialize global filter by default.***
 
@@ -60,6 +61,7 @@ ctx.DbSetFilter<Customer>(q => q.Where(x => x.IsActive));
 var list = ctx.Customers.ToList();
 
 ```
+{% include component-try-it.html href='https://dotnetfiddle.net/3Xz39f' %}
 
 ***Use entities context constructor to make some filter "global" to all context.***
 
@@ -76,10 +78,11 @@ var ctx = new EntitiesContext();
 // CREATE a disabled filter
 ctx.DbSetFilter<Customer>(MyEnum.EnumValue, q => q.Where(x => x.IsActive), false);
 
-// SELECT * FROM Customer WHERE IsActive = true
+// SELECT * FROM Customer
 var list = ctx.Customers.DbSetFilter(MyEnum.EnumValue).ToList();
 
 ```
+{% include component-try-it.html href='https://dotnetfiddle.net/XmtVWN' %}
 
 ## EF+ Query Filter By Inheritance/Interface
 
@@ -97,13 +100,14 @@ ctx.DbSetFilter<BaseDog>(q => q.Where(x => !x.IsDangerous));
 // CREATE filter by interface
 ctx.DbSetFilter<IAnimal>(q => q.Where(x => x.IsDomestic));
 
-// SELECT * FROM Cat WHERE IsDomestic = true
+// SELECT * FROM Cat WHERE IsDomestic = 1
 var cats = ctx.Cats.ToList();
 
-// SELECT * FROM Dog WHERE IsDomestic = true AND IsDangerous = false
+// SELECT * FROM Dog WHERE IsDomestic = 1 AND IsDangerous = 0
 var dogs = ctx.Dogs.ToList();
 
 ```
+{% include component-try-it.html href='https://dotnetfiddle.net/flFnBf' %}
 
 ## EF+ Query Filter Enable/Disable
 
@@ -118,19 +122,20 @@ var ctx = new EntitiesContext();
 // CREATE filter by interface
 ctx.DbSetFilter<IAnimal>(MyEnum.EnumValue, q => q.Where(x => x.IsDomestic))
 
-// DISABLE filter only for class inheriting from BaseDog
-ctx.DbSetFilter<BaseDog>(MyEnum.EnumValue).Disable();
+// DISABLE filter
+ctx.DbSetFilter(MyEnum.EnumValue).Disable();
 
 // SELECT * FROM Dog
-var dogs = ctx.Dogs.ToList();
+var dogs = ctx.Dogs.ToList(); 
 
 // ENABLE filter
-ctx.DbSetFilter<BaseDog>(MyEnum.EnumValue).Enable();
+ctx.DbSetFilter(MyEnum.EnumValue).Enable();
 
 // SELECT * FROM Dog WHERE IsDomestic = true
 var dogs = ctx.Dogs.ToList();
 
 ```
+{% include component-try-it.html href='https://dotnetfiddle.net/girbYB' %}
 
 ## EF+ Query Filter AsNoFilter
 
@@ -151,3 +156,4 @@ var list = ctx.Customers.ToList();
 var list = ctx.Customers.AsNoDbSetFilter().ToList();
 
 ```
+{% include component-try-it.html href='https://dotnetfiddle.net/ZIA1kt' %}

docs2/pages/documentations/query-deferred.md

@@ -22,6 +22,7 @@ var count = ctx.Customers.Count();
 var count = ctx.Customers.FromCache().Count();
 
 ```
+{% include component-try-it.html href='https://dotnetfiddle.net/WgpFfH' %}
 
 Here comes in play the deferred query which acts exactly like deferred methods, by modifying the query expression without resolving it.
 
@@ -35,6 +36,7 @@ var ctx = new EntitiesContext();
 var count = ctx.Customers.DeferredCount().FromCache();
 
 ```
+{% include component-try-it.html href='https://dotnetfiddle.net/ZChhmD' %}
 
 #### All LINQ IQueryable extension methods and overloads are supported:
 
@@ -75,6 +77,7 @@ ctx.Customers.DeferredCount().FromCache();
 ctx.Customers.DeferredCount().FutureValue();
 
 ```
+{% include component-try-it.html href='https://dotnetfiddle.net/5KcNj3' %}
 
 ## EF+ Query Deferred Execute
 
@@ -90,6 +93,7 @@ var countDeferred = ctx.Customers.DeferredCount();
 var count = countDeferred.Execute();
 
 ```
+{% include component-try-it.html href='https://dotnetfiddle.net/sXOfNB' %}
 
 ## EF+ Query Deferred Execute Async
 

docs2/pages/documentations/query-include-filter.md

@@ -120,7 +120,7 @@ When an immediate method is invoked to resolve the query, the initial query is m
 {% include template-example.html %} 
 ```csharp
 
-var list = ctx.Orders.IncludeFilter(x => x.OrderItems.Where(y => !y.IsSoftDeleted)
+var list = ctx.Orders.IncludeFilter(x => x.OrderItems.Where(y => !y.IsSoftDeleted))
                      .Take(10)
                      .ToList();