Merge pull request #49916 from dotnet/main

Merge main into live

Author: dotnet-policy-service[bot]

.openpublishing.redirection.orleans.json

@@ -43,6 +43,26 @@
         {
             "source_path_from_root": "/docs/orleans/implementation/cluster-configuration.md",
             "redirect_url": "/dotnet/orleans/implementation/cluster-management"
+        },
+        {
+            "source_path_from_root": "/docs/orleans/deployment/multi-cluster-support/global-single-instance.md",
+            "redirect_url": "/dotnet/orleans/deployment/"
+        },
+        {
+            "source_path_from_root": "/docs/orleans/deployment/multi-cluster-support/gossip-channels.md",
+            "redirect_url": "/dotnet/orleans/deployment/"
+        },
+        {
+            "source_path_from_root": "/docs/orleans/deployment/multi-cluster-support/multi-cluster-configuration.md",
+            "redirect_url": "/dotnet/orleans/deployment/"
+        },
+        {
+            "source_path_from_root": "/docs/orleans/deployment/multi-cluster-support/overview.md",
+            "redirect_url": "/dotnet/orleans/deployment/"
+        },
+        {
+            "source_path_from_root": "/docs/orleans/deployment/multi-cluster-support/silo-configuration.md",
+            "redirect_url": "/dotnet/orleans/deployment/"
         }
 
     ]

docs/azure/includes/dotnet-all.md

@@ -110,6 +110,12 @@ If you're migrating an app to .NET 10, the breaking changes listed here might af
 | [Streaming HTTP responses enabled by default in browser HTTP clients](networking/10.0/default-http-streaming.md) | Behavioral change |
 | [`Uri` length limits removed](networking/10.0/uri-length-limits-removed.md) | Behavioral change |
 
+## Reflection
+
+| Title | Type of change    | Introduced version |
+|-------|-------------------|--------------------|
+| [More restricted annotations on InvokeMember/FindMembers/DeclaredMembers](reflection/10/ireflect-damt-annotations.md) | Behavioral/source incompatible | |
+
 ## SDK and MSBuild
 
 | Title | Type of change    |

docs/azure/includes/dotnet-new.md

@@ -0,0 +1,64 @@
+---
+title: "Breaking change: More restricted annotations on InvokeMember/FindMembers/DeclaredMembers"
+description: "Learn about the breaking change in .NET 10 where System.Reflection APIs InvokeMember, FindMembers, and DeclaredMembers use more restricted annotations instead of DynamicallyAccessedMemberTypes.All."
+ms.date: 10/09/2025
+ai-usage: ai-generated
+---
+
+# More restricted annotations on InvokeMember/FindMembers/DeclaredMembers
+
+Starting in .NET 10, the <xref:System.Reflection> APIs <xref:System.Reflection.IReflect.InvokeMember%2A>, <xref:System.Type.FindMembers%2A>, and <xref:System.Reflection.TypeInfo.DeclaredMembers> use more restricted annotations instead of <xref:System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.All?displayProperty=nameWithType>.
+
+This change affects scenarios where developers implement the <xref:System.Reflection.IReflect> interface or derive from <xref:System.Reflection.TypeInfo>. The previous use of <xref:System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.All?displayProperty=nameWithType> was overly permissive and could lead to unintended behavior, such as capturing interface methods implemented by a class or generating warnings due to unsafe reflection calls.
+
+## Version introduced
+
+.NET 10
+
+## Previous behavior
+
+Previously, the [affected APIs](#affected-apis) used the <xref:System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.All?displayProperty=nameWithType> annotation, which was overly permissive. This could result in capturing additional members, such as interface methods implemented by a class, and potentially cause runtime warnings or unsafe reflection calls.
+
+## New behavior
+
+The [affected APIs](#affected-apis) now use more restricted annotations, which provide better control over the members captured during reflection.
+
+## Type of breaking change
+
+This change is a [behavioral change](../../categories.md#behavioral-change) and can affect [source compatibility](../../categories.md#source-compatibility).
+
+## Reason for change
+
+The change was introduced to improve the accuracy of annotations in <xref:System.Reflection> APIs and to address issues caused by the overly permissive <xref:System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.All?displayProperty=nameWithType> annotation. This ensures better compatibility with trimming and reflection scenarios, reduces run-time warnings, and prevents unsafe reflection calls.
+
+## Recommended action
+
+If you implement <xref:System.Reflection.IReflect> or derive from <xref:System.Reflection.TypeInfo>, review your code and update annotations to align with the new behavior. Specifically:
+
+1. Replace <xref:System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.All?displayProperty=nameWithType> annotations with more restricted annotations, such as <xref:System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicMethods?displayProperty=nameWithType>, <xref:System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicMethods?displayProperty=nameWithType>, or other appropriate types.
+
+   The following code snippet shows an example.
+
+   ```csharp
+   class MyType : IReflect
+   {
+       [DynamicallyAccessedMembers(
+           DynamicallyAccessedMemberTypes.PublicFields | DynamicallyAccessedMemberTypes.NonPublicFields |
+           DynamicallyAccessedMemberTypes.PublicMethods | DynamicallyAccessedMemberTypes.NonPublicMethods |
+           DynamicallyAccessedMemberTypes.PublicProperties | DynamicallyAccessedMemberTypes.NonPublicProperties |
+           DynamicallyAccessedMemberTypes.PublicConstructors | DynamicallyAccessedMemberTypes.NonPublicConstructors)]
+        public object InvokeMember(string name, BindingFlags invokeAttr, Binder? binder, object? target,
+            object?[]? args, ParameterModifier[]? modifiers, CultureInfo? culture, string[]? namedParameters)
+        { }
+   }
+   ```
+
+1. Test reflection scenarios to ensure that the updated annotations capture the intended members and don't introduce run-time errors or warnings.
+
+For more information on `DynamicallyAccessedMembers` annotations and their usage, see [Prepare .NET libraries for trimming](../../../deploying/trimming/prepare-libraries-for-trimming.md).
+
+## Affected APIs
+
+- <xref:System.Reflection.IReflect.InvokeMember(System.String,System.Reflection.BindingFlags,System.Reflection.Binder,System.Object,System.Object[],System.Reflection.ParameterModifier[],System.Globalization.CultureInfo,System.String[])?displayProperty=fullName>
+- <xref:System.Type.FindMembers(System.Reflection.MemberTypes,System.Reflection.BindingFlags,System.Reflection.MemberFilter,System.Object)?displayProperty=fullName>
+- <xref:System.Reflection.TypeInfo.DeclaredMembers?displayProperty=fullName>

docs/core/compatibility/10.0.md

@@ -122,6 +122,8 @@ items:
                 href: networking/10.0/uri-length-limits-removed.md
           - name: Reflection
             items:
+              - name: More restricted annotations on InvokeMember/FindMembers/DeclaredMembers
+                href: reflection/10/ireflect-damt-annotations.md
               - name: Type.MakeGenericSignatureType argument validation
                 href: reflection/10/makegeneric-signaturetype-validation.md
           - name: SDK and MSBuild

docs/core/compatibility/reflection/10/ireflect-damt-annotations.md

@@ -9,7 +9,7 @@ ms.custom: linux-related-content
 
 # Install the .NET SDK or the .NET Runtime on Debian
 
-This article describes how to install .NET on Debian. When a Debian version falls out of support, .NET is no longer supported with that version. However, these instructions may help you to get .NET running on those versions, even though it isn't supported.
+This article describes how to install .NET on Debian. When a Debian version falls out of support, .NET is no longer supported with that version. However, these instructions might help you to get .NET running on those versions, even though it isn't supported.
 
 [!INCLUDE [linux-intro-sdk-vs-runtime](includes/linux-intro-sdk-vs-runtime.md)]
 
@@ -42,8 +42,6 @@ sudo dpkg -i packages-microsoft-prod.deb
 rm packages-microsoft-prod.deb
 ```
 
-[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]
-
 # [.NET 10](#tab/dotnet10)
 
 [!INCLUDE [linux-install-package-manager-x64-arm64](includes/linux-install-package-manager-x64-arm64.md)]
@@ -76,8 +74,6 @@ rm packages-microsoft-prod.deb
 
 # [.NET 10](#tab/dotnet10)
 
-[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]
-
 [!INCLUDE [linux-install-package-manager-x64-arm64](includes/linux-install-package-manager-x64-arm64.md)]
 
 [!INCLUDE [linux-apt-install-100](includes/linux-install-100-apt.md)]
@@ -98,18 +94,18 @@ rm packages-microsoft-prod.deb
 
 ## Use APT to update .NET
 
-When a new patch release is available for .NET, you can simply upgrade it through APT with the following commands:
+When a new patch release is available for .NET, you can upgrade it through APT with the following commands:
 
 ```bash
 sudo apt-get update
 sudo apt-get upgrade
 ```
 
-If you've upgraded your Linux distribution since installing .NET, you may need to reconfigure the Microsoft package repository. Run the installation instructions for your current distribution version to upgrade to the appropriate package repository for .NET updates.
+If you upgraded your Linux distribution since installing .NET, you might need to reconfigure the Microsoft package repository. Run the installation instructions for your current distribution version to upgrade to the appropriate package repository for .NET updates.
 
 ## Troubleshooting
 
-This section provides information on common errors you may get while using APT to install .NET.
+This section provides information on common errors you might get while using APT to install .NET.
 
 ### Unable to find package
 
@@ -123,7 +119,7 @@ If you're using Debian 12 or later, try the following commands:
 
 [!INCLUDE [package-manager-failed-to-find-deb-new](includes/package-manager-failed-to-find-deb-new.md)]
 
-If you're using a Debian version prior to 12, try the following commands:
+If you're using a Debian version older than 12, try the following commands:
 
 [!INCLUDE [package-manager-failed-to-find-deb-classic](includes/package-manager-failed-to-find-deb-classic.md)]
 

docs/core/compatibility/toc.yml

@@ -26,7 +26,7 @@ The following table is a list of currently supported .NET releases and the versi
 |--------|----------|
 | 43     | 10, 9, 8 |
 | 42     | 10, 9, 8 |
-| 41     | 9, 8     |
+| 41     | 10, 9, 8 |
 
 [!INCLUDE [versions-not-supported](includes/versions-not-supported.md)]
 

docs/core/install/linux-debian.md

@@ -3,7 +3,7 @@ title: Install .NET on openSUSE Leap
 description: Learn about which versions of .NET SDK and .NET Runtime are supported, and how to install .NET on openSUSE Leap.
 author: adegeo
 ms.author: adegeo
-ms.date: 11/07/2025
+ms.date: 11/14/2025
 ms.custom: linux-related-content
 ---
 
@@ -46,20 +46,22 @@ sudo chown root:root /etc/zypp/repos.d/microsoft-prod.repo
 
 # [.NET 10](#tab/dotnet10)
 
-[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]
-
 [!INCLUDE [linux-install-package-manager-x64-arm64](includes/linux-install-package-manager-x64-arm64.md)]
 
 [!INCLUDE [linux-zyp-install-100](includes/linux-install-100-zyp.md)]
 
 # [.NET 9](#tab/dotnet9)
 
+openSUSE Leap 16 is newly supported with .NET. The packages for .NET 9 aren't published yet.
+
 [!INCLUDE [linux-install-package-manager-x64-only](includes/linux-install-package-manager-x64-only.md)]
 
 [!INCLUDE [linux-zyp-install-90](includes/linux-install-90-zyp.md)]
 
 # [.NET 8](#tab/dotnet8)
 
+openSUSE Leap 16 is newly supported with .NET. The packages for .NET 8 aren't published yet.
+
 [!INCLUDE [linux-install-package-manager-x64-only](includes/linux-install-package-manager-x64-only.md)]
 
 [!INCLUDE [linux-zyp-install-80](includes/linux-install-80-zyp.md)]

docs/core/install/linux-fedora.md

@@ -3,7 +3,7 @@ title: Install .NET on RHEL and CentOS Stream
 description: Learn about which versions of .NET are supported, and how to install .NET on Red Hat Enterprise Linux and CentOS Stream.
 author: adegeo
 ms.author: adegeo
-ms.date: 11/07/2025
+ms.date: 11/14/2025
 ms.custom: linux-related-content
 ---
 
@@ -15,7 +15,7 @@ ms.custom: linux-related-content
 
 ## Register your Red Hat subscription
 
-To install .NET from Red Hat on RHEL, you first need to register using the Red Hat Subscription Manager. If this hasn't been done on your system, or if you're unsure, see the [Red Hat Product Documentation for .NET](https://access.redhat.com/documentation/en-us/net/8.0).
+To install .NET from Red Hat on RHEL, you first need to register using the Red Hat Subscription Manager. If this hasn't been done on your system, or if you're unsure, see the [Red Hat Product Documentation for .NET](https://access.redhat.com/documentation/en-us/net/10.0).
 
 > [!IMPORTANT]
 > The previous statement doesn't apply to CentOS Stream.
@@ -28,7 +28,7 @@ The following table is a list of currently supported .NET releases on both RHEL
 |---------------------------------------|----------|
 | [RHEL 10](#rhel-10)                   | 10, 9, 8 |
 | [RHEL 9](#rhel-9)                     | 10, 9, 8 |
-| [RHEL 8](#rhel-8)                     | 9, 8     |
+| [RHEL 8](#rhel-8)                     | 10, 9, 8 |
 | [CentOS Stream 10](#centos-stream-10) | 10, 9, 8 |
 | [CentOS Stream 9](#centos-stream-9)   | 10, 9, 8 |
 
@@ -44,8 +44,6 @@ The following table is a list of currently supported .NET releases on both RHEL
 
 ## RHEL 10
 
-[!INCLUDE [linux-release-wait](includes/linux-release-wait.md)]
-
 .NET is included in the [AppStream repositories](https://access.redhat.com/support/policy/updates/rhel-app-streams-life-cycle) for RHEL 10.
 
 [!INCLUDE [linux-dnf-install-100](includes/linux-install-100-dnf.md)]
@@ -60,7 +58,7 @@ The following table is a list of currently supported .NET releases on both RHEL
 
 .NET is included in the [AppStream repositories](https://access.redhat.com/support/policy/updates/rhel-app-streams-life-cycle) for RHEL 8.
 
-[!INCLUDE [linux-dnf-install-90](includes/linux-install-90-dnf.md)]
+[!INCLUDE [linux-dnf-install-100](includes/linux-install-100-dnf.md)]
 
 ## CentOS Stream 10