Fixes #45018 (#45024)

Author: Cam Soper

docs/core/whats-new/dotnet-10/libraries.md

@@ -74,28 +74,7 @@ public static class StringNormalizationExtensions
 
 Numerical string comparison is a highly requested feature for comparing strings numerically instead of lexicographically. For example, `2` is less than `10`, so `"2"` should appear before `"10"` when ordered numerically. Similarly, `"2"` and `"02"` are equal numerically. With the new `CompareOptions.NumericOrdering` <!--xref:System.Globalization.CompareOptions.NumericOrdering--> option, it's now possible to do these types of comparisons:
 
-<!-- >:::code language="csharp" source="../snippets/dotnet-10/csharp/snippets.cs" id="snippet1"::: -->
-
-```csharp
-StringComparer numericStringComparer = StringComparer.Create(CultureInfo.CurrentCulture, CompareOptions.NumericOrdering);
-
-Console.WriteLine(numericStringComparer.Equals("02", "2"));
-// Output: True
-
-foreach (string os in new[] { "Windows 8", "Windows 10", "Windows 11" }.Order(numericStringComparer))
-{
-    Console.WriteLine(os);
-}
-
-// Output:
-// Windows 8
-// Windows 10
-// Windows 11
-
-HashSet<string> set = new HashSet<string>(numericStringComparer) { "007" };
-Console.WriteLine(set.Contains("7"));
-// Output: True 
-```
+:::code language="csharp" source="../snippets/dotnet-10/csharp/snippets.cs" id="snippet_numericOrdering":::
 
 Note that this option is not valid for the following index-based string operations: `IndexOf`, `LastIndexOf`, `StartsWith`, `EndsWith`, `IsPrefix`, and `IsSuffix`.
 
@@ -142,47 +121,15 @@ public class OrderedDictionary<TKey, TValue>
 
 This index can then be used with <xref:System.Collections.Generic.OrderedDictionary`2.GetAt*>/<xref:System.Collections.Generic.OrderedDictionary`2.SetAt*> for fast access to the entry. An example usage of the new `TryAdd` overload is to add or update a key/value pair in the ordered dictionary:
 
-<!-- :::code language="csharp" source="../snippets/dotnet-10/csharp/snippets.cs" id="snippet2"::: -->
-
-```csharp
-// Try to add a new key with value 1.
-if (!orderedDictionary.TryAdd(key, 1, out int index))
-{
-    // Key was present, so increment the existing value instead.
-    int value = orderedDictionary.GetAt(index).Value;
-    orderedDictionary.SetAt(index, value + 1);
-}
-```
+:::code language="csharp" source="../snippets/dotnet-10/csharp/snippets.cs" id="snippet_getAtSetAt":::
 
 This new API is already used in <xref:System.Json.JsonObject> and improves the performance of updating properties by 10-20%.
 
 ## Allow specifying ReferenceHandler in `JsonSourceGenerationOptions`
 
 When using source generators for JSON serialization, the generated context will throw when cycles are serialized or deserialized. This behavior can now be customized by specifying the <xref:System.Text.Json.Serialization.ReferenceHandler> in the <xref:System.Text.Json.Serialization.JsonSourceGenerationOptionsAttribute>. Here is an example using `JsonKnownReferenceHandler.Preserve`:
 
-<!-- :::code language="csharp" source="../snippets/dotnet-10/csharp/snippets.cs" id="snippet3"::: -->
-
-```csharp
-public static void MakeSelfRef()
-{
-    SelfReference selfRef = new SelfReference();
-    selfRef.Me = selfRef;
-
-    Console.WriteLine(JsonSerializer.Serialize(selfRef, ContextWithPreserveReference.Default.SelfReference));
-    // Output: {"$id":"1","Me":{"$ref":"1"}}
-}
-
-[JsonSourceGenerationOptions(ReferenceHandler = JsonKnownReferenceHandler.Preserve)]
-[JsonSerializable(typeof(SelfReference))]
-internal partial class ContextWithPreserveReference : JsonSerializerContext
-{
-}
-
-internal class SelfReference
-{
-    public SelfReference Me { get; set; } = null!;
-}
-```
+:::code language="csharp" source="../snippets/dotnet-10/csharp/snippets.cs" id="snippet_selfReference":::
 
 ## More left-handed matrix transformation methods
 

docs/core/whats-new/snippets/dotnet-10/csharp/Project.csproj

@@ -2,7 +2,7 @@
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
-    <TargetFramework>net9.0</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
   </PropertyGroup>

docs/core/whats-new/snippets/dotnet-10/csharp/snippets.cs

@@ -4,10 +4,9 @@
 
 public static class Snippets
 {
-/*
     public static void NumericOrdering()
     {
-        #region snippet1
+        #region snippet_numericOrdering
         StringComparer numericStringComparer = StringComparer.Create(CultureInfo.CurrentCulture, CompareOptions.NumericOrdering);
 
         Console.WriteLine(numericStringComparer.Equals("02", "2"));
@@ -31,7 +30,7 @@ public static void NumericOrdering()
 
     public static void IncrementValue(OrderedDictionary<string, int> orderedDictionary, string key)
     {
-        #region snippet2
+        #region snippet_getAtSetAt
         // Try to add a new key with value 1.
         if (!orderedDictionary.TryAdd(key, 1, out int index))
         {
@@ -41,14 +40,12 @@ public static void IncrementValue(OrderedDictionary<string, int> orderedDictiona
         }
         #endregion
     }
-*/
 }
 
 
 public partial class SomeClass
 {
-    /*
-    #region snippet3
+    #region snippet_selfReference
     public static void MakeSelfRef()
     {
         SelfReference selfRef = new SelfReference();
@@ -69,6 +66,5 @@ internal class SelfReference
         public SelfReference Me { get; set; } = null!;
     }
     #endregion
-    */
 }