Fix to #2873 - ThenInclude required?

Added example for using single Include/ThenInclude method call to load multiple navigations.
dotnet · Nov 16, 2020 · 0d42eb1 · 0d42eb1
1 parent 1388fe7
commit 0d42eb1
Show file tree

Hide file tree

Showing 2 changed files with 21 additions and 6 deletions.
diff --git a/entity-framework/core/querying/related-data/eager.md b/entity-framework/core/querying/related-data/eager.md
@@ -41,6 +41,11 @@ You may want to include multiple related entities for one of the entities that i
 
 [!code-csharp[Main](../../../../samples/core/Querying/RelatedData/Program.cs#MultipleLeafIncludes)]
 
+> [!TIP]
+> You can also load multiple navigations using a single `Include` method. This is possible for navigation "chains" that are all references, or when they end with a single collection.
+
+[!code-csharp[Main](../../../../samples/core/Querying/RelatedData/Program.cs#IncludeMultipleNavigationsWithSingleInclude)]
+
 ## Filtered include
 
 > [!NOTE]

diff --git a/samples/core/Querying/RelatedData/Program.cs b/samples/core/Querying/RelatedData/Program.cs
@@ -65,6 +65,19 @@ static void Main(string[] args)
             }
             #endregion
 
+            #region IncludeTree
+            using (var context = new BloggingContext())
+            {
+                var blogs = context.Blogs
+                    .Include(blog => blog.Posts)
+                        .ThenInclude(post => post.Author)
+                            .ThenInclude(author => author.Photo)
+                    .Include(blog => blog.Owner)
+                        .ThenInclude(owner => owner.Photo)
+                    .ToList();
+            }
+            #endregion
+
             #region MultipleLeafIncludes
             using (var context = new BloggingContext())
             {
@@ -77,15 +90,12 @@ static void Main(string[] args)
             }
             #endregion
 
-            #region IncludeTree
+            #region IncludeMultipleNavigationsWithSingleInclude
             using (var context = new BloggingContext())
             {
                 var blogs = context.Blogs
-                    .Include(blog => blog.Posts)
-                        .ThenInclude(post => post.Author)
-                            .ThenInclude(author => author.Photo)
-                    .Include(blog => blog.Owner)
-                        .ThenInclude(owner => owner.Photo)
+                    .Include(blog => blog.Owner.AuthoredPosts)
+                        .ThenInclude(post => post.Blog.Owner.Photo)
                     .ToList();
             }
             #endregion