Change tracker docs

Fixes #2725 Fixes #2707 Fixes #2525 Fixes #2524 Fixes #2331 Fixes #2076 Fixes #1489 Fixes #1453 Fixes #1398 Fixes #1339 Fixes #1235 Fixes #1007 Fixes #863 Fixes #786 Fixes #531 Fixes #505
dotnet · Dec 30, 2020 · 8573cf9 · 8573cf9
1 parent 8c8d7d3
commit 8573cf9
Show file tree

Hide file tree

Showing 51 changed files with 10,622 additions and 9 deletions.
diff --git a/entity-framework/core/change-tracking/_static/debug-view.png b/entity-framework/core/change-tracking/_static/debug-view.png
diff --git a/entity-framework/core/change-tracking/change-detection.md b/entity-framework/core/change-tracking/change-detection.md
diff --git a/entity-framework/core/change-tracking/debug-views.md b/entity-framework/core/change-tracking/debug-views.md
diff --git a/entity-framework/core/change-tracking/entity-entries.md b/entity-framework/core/change-tracking/entity-entries.md
diff --git a/entity-framework/core/change-tracking/entity-state.md.stub b/entity-framework/core/change-tracking/entity-state.md.stub
diff --git a/entity-framework/core/change-tracking/find-local-queries.md.stub b/entity-framework/core/change-tracking/find-local-queries.md.stub
diff --git a/entity-framework/core/change-tracking/identity-resolution.md b/entity-framework/core/change-tracking/identity-resolution.md
diff --git a/entity-framework/core/change-tracking/index.md b/entity-framework/core/change-tracking/index.md
diff --git a/entity-framework/core/change-tracking/index.md.stub b/entity-framework/core/change-tracking/index.md.stub
diff --git a/entity-framework/core/change-tracking/miscellaneous.md b/entity-framework/core/change-tracking/miscellaneous.md
diff --git a/entity-framework/core/change-tracking/notification-entities.md.stub b/entity-framework/core/change-tracking/notification-entities.md.stub
diff --git a/entity-framework/core/change-tracking/property-changes.md.stub b/entity-framework/core/change-tracking/property-changes.md.stub
diff --git a/entity-framework/core/change-tracking/proxies.md.stub b/entity-framework/core/change-tracking/proxies.md.stub
diff --git a/entity-framework/core/change-tracking/relationship-changes.md b/entity-framework/core/change-tracking/relationship-changes.md
diff --git a/entity-framework/core/change-tracking/relationship-changes.md.stub b/entity-framework/core/change-tracking/relationship-changes.md.stub
diff --git a/entity-framework/toc.yml b/entity-framework/toc.yml
@@ -213,15 +213,22 @@
       - name: Explicit values for generated properties
         href: core/saving/explicit-values-generated-properties.md
 
-    #- name: Change tracking
-    #  items:
-    #  - name: Overview
-    #  - name: Property changes
-    #  - name: Relationship changes
-    #  - name: Find and local queries
-    #  - name: Accessing entity state
-    #  - name: Notification entities
-    #  - name: Change tracking proxies
+    - name: Change tracking
+      items:
+      - name: Overview
+        href: core/change-tracking/index.md
+      - name: Accessing tracked entities
+        href: core/change-tracking/entity-entries.md
+      - name: Changing foreign keys and navigations
+        href: core/change-tracking/relationship-changes.md
+      - name: Change detection and notifications
+        href: core/change-tracking/change-detection.md
+      - name: Identity resolution
+        href: core/change-tracking/identity-resolution.md
+      - name: Additional change tracking features
+        href: core/change-tracking/miscellaneous.md
+      - name: Change tracker debugging
+        href: core/change-tracking/debug-views.md
 
     - name: Logging, events, and diagnostics
       items:

diff --git a/samples/core/ChangeTracking/AccessingTrackedEntities/AccessingTrackedEntities.csproj b/samples/core/ChangeTracking/AccessingTrackedEntities/AccessingTrackedEntities.csproj
@@ -0,0 +1,14 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+    <PropertyGroup>
+        <OutputType>Exe</OutputType>
+        <TargetFramework>netcoreapp3.1</TargetFramework>
+        <RootNamespace />
+    </PropertyGroup>
+
+    <ItemGroup>
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="5.0.1" />
+        <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="5.0.1" />
+    </ItemGroup>
+
+</Project>
diff --git a/samples/core/ChangeTracking/AccessingTrackedEntities/Program.cs b/samples/core/ChangeTracking/AccessingTrackedEntities/Program.cs
@@ -0,0 +1,30 @@
+using System;
+
+public class Program
+{
+    public static void Main()
+    {
+        Console.WriteLine("Samples for _Accessing Tracked Entities_");
+        Console.WriteLine();
+
+        Samples.Using_DbContext_Entry_and_EntityEntry_instances_1();
+        Samples.Work_with_the_entity_1();
+        Samples.Work_with_the_entity_2();
+        Samples.Work_with_a_single_property_1();
+        Samples.Work_with_a_single_navigation_1();
+        Samples.Work_with_a_single_navigation_2();
+        Samples.Work_with_all_properties_of_an_entity_1();
+        Samples.Work_with_all_navigations_of_an_entity_1();
+        Samples.Work_with_all_members_of_an_entity_1();
+
+        Samples.Find_and_FindAsync_1();
+        Samples.Find_and_FindAsync_2();
+
+        Samples.Using_ChangeTracker_Entries_to_access_all_tracked_entities_1();
+
+        Samples.Using_DbSet_Local_to_query_tracked_entities_1();
+        Samples.Using_DbSet_Local_to_query_tracked_entities_2();
+        Samples.Using_DbSet_Local_to_query_tracked_entities_3();
+        Samples.Using_DbSet_Local_to_query_tracked_entities_4();
+    }
+}