docs(.NET10): Shell SearchHandler trimming guidance — prefer ItemTemplate; feature switch note; update ms.date (#2996)

Author: davidortinau

docs/fundamentals/shell/search.md

@@ -1,7 +1,7 @@
 ---
 title: ".NET MAUI Shell search"
 description: "Learn how .NET MAUI Shell apps can use integrated search functionality that's provided by a search box that can be added to the top of each page."
-ms.date: 10/30/2024
+ms.date: 08/19/2025
 ---
 
 # .NET MAUI Shell search
@@ -122,6 +122,13 @@ The `AnimalSearchHandler.OnQueryChanged` method returns a `List` of `Animal` obj
 
 ::: moniker-end
 
+::: moniker range=">=net-maui-10.0"
+
+> [!TIP]
+> In .NET 10, trimming defaults and feature switches mean `SearchHandler.DisplayMemberName` is ignored when full trimming or Native AOT is enabled. Prefer using `ItemTemplate` for results, which is trim-safe and supported across platforms. If you must use `DisplayMemberName` in partially trimmed scenarios, you can opt back in by setting the `MauiShellSearchResultsRendererDisplayMemberNameSupported` feature switch to `true` in your project file. For details and tradeoffs, see [Trimming feature switches](~/deployment/trimming.md#trimming-feature-switches).
+
+::: moniker-end
+
 The `ShowsResults` property is set to `true`, so that search suggestions are displayed as the user enters a search query:
 
 :::image type="content" source="media/search/search-results.png" alt-text="Screenshot of search results in a Shell SearchHandler, with results for the partial string M.":::