Add FrameworkConditionAttribute for conditional test execution based on .NET framework

global.json

@@ -1,39 +1 @@
-{
-  "tools": {
-    "dotnet": "10.0.100-preview.7.25359.101",
-    "runtimes": {
-      "dotnet": [
-        "3.1.32",
-        "6.0.36",
-        "7.0.20",
-        "8.0.14",
-        "9.0.3"
-      ],
-      "dotnet/x86": [
-        "3.1.32",
-        "6.0.36",
-        "9.0.3"
-      ],
-      "aspnetcore": [
-        "9.0.3"
-      ]
-    },
-    "vs": {
-      "version": "17.8.0"
-    }
-  },
-  "sdk": {
-    "version": "10.0.100-preview.7.25359.101",
-    "paths": [
-      ".dotnet",
-      "$host$"
-    ],
-    "errorMessage": "The .NET SDK could not be found, please run ./build.cmd on Windows or ./build.sh on Linux and macOS.",
-    "allowPrerelease": true,
-    "rollForward": "latestFeature"
-  },
-  "msbuild-sdks": {
-    "Microsoft.DotNet.Arcade.Sdk": "10.0.0-beta.25358.3",
-    "MSBuild.Sdk.Extras": "3.0.44"
-  }
-}
+{"sdk":{"version":"8.0.117","rollForward":"latestMinor"}}

src/TestFramework/TestFramework/Attributes/TestMethod/FrameworkConditionAttribute.cs

@@ -0,0 +1,119 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+using System.Runtime.InteropServices;
+
+namespace Microsoft.VisualStudio.TestTools.UnitTesting;
+
+/// <summary>
+/// This attribute is used to conditionally control whether a test class or a test method will run or be ignored based on the .NET framework being used.
+/// </summary>
+/// <remarks>
+/// This attribute isn't inherited. Applying it to a base class will not affect derived classes.
+/// </remarks>
+[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, Inherited = false, AllowMultiple = false)]
+public sealed class FrameworkConditionAttribute : ConditionBaseAttribute
+{
+    private readonly Frameworks _frameworks;
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="FrameworkConditionAttribute"/> class.
+    /// </summary>
+    /// <param name="mode">Decides whether the frameworks will be included or excluded.</param>
+    /// <param name="frameworks">The .NET frameworks that this test includes/excludes.</param>
+    public FrameworkConditionAttribute(ConditionMode mode, Frameworks frameworks)
+        : base(mode)
+    {
+        _frameworks = frameworks;
+        IgnoreMessage = mode == ConditionMode.Include
+            ? $"Test is only supported on {frameworks}"
+            : $"Test is not supported on {frameworks}";
+    }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="FrameworkConditionAttribute"/> class.
+    /// </summary>
+    /// <param name="frameworks">The .NET frameworks that this test supports.</param>
+    public FrameworkConditionAttribute(Frameworks frameworks)
+        : this(ConditionMode.Include, frameworks)
+    {
+    }
+
+    /// <summary>
+    /// Gets a value indicating whether the test method or test class should run.
+    /// </summary>
+    public override bool ShouldRun => IsCurrentFrameworkSupported();
+
+    /// <summary>
+    /// Gets the ignore message (in case <see cref="ShouldRun"/> returns <see langword="false"/>).
+    /// </summary>
+    public override string? IgnoreMessage { get; }
+
+    /// <summary>
+    /// Gets the group name for this attribute.
+    /// </summary>
+    public override string GroupName => nameof(FrameworkConditionAttribute);
+
+    private bool IsCurrentFrameworkSupported()
+    {
+        Frameworks currentFramework = GetCurrentFramework();
+        return (_frameworks & currentFramework) != 0;
+    }
+
+    private static Frameworks GetCurrentFramework()
+    {
+        string frameworkDescription = RuntimeInformation.FrameworkDescription;
+
+        // Check for UWP first as it may also have .NET Core or .NET in its description
+        if (IsRunningOnUwp())
+        {
+            return Frameworks.Uwp;
+        }
+
+        // Check for .NET Framework
+        if (frameworkDescription.StartsWith(".NET Framework", StringComparison.OrdinalIgnoreCase))
+        {
+            return Frameworks.NetFramework;
+        }
+
+        // Check for .NET Core
+        if (frameworkDescription.StartsWith(".NET Core", StringComparison.OrdinalIgnoreCase))
+        {
+            return Frameworks.NetCore;
+        }
+
+        // Check for .NET 5+ (includes .NET 5, 6, 7, 8, 9, etc.)
+        if (frameworkDescription.StartsWith(".NET ", StringComparison.OrdinalIgnoreCase))
+        {
+            return Frameworks.Net;
+        }
+
+        // Default to .NET for unknown cases
+        return Frameworks.Net;
+    }
+
+    private static bool IsRunningOnUwp()
+    {
+        try
+        {
+            // Try to access Windows.ApplicationModel.Package.Current
+            // This is only available in UWP applications
+            var packageType = Type.GetType("Windows.ApplicationModel.Package, Windows.Runtime");
+            if (packageType is not null)
+            {
+                var currentProperty = packageType.GetProperty("Current");
+                if (currentProperty is not null)
+                {
+                    var current = currentProperty.GetValue(null);
+                    return current is not null;
+                }
+            }
+        }
+        catch
+        {
+            // If we can't access the UWP APIs, we're not running on UWP
+        }
+
+        return false;
+    }
+}

src/TestFramework/TestFramework/Attributes/TestMethod/Frameworks.cs

@@ -0,0 +1,31 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+namespace Microsoft.VisualStudio.TestTools.UnitTesting;
+
+/// <summary>
+/// An enum that is used with <see cref="FrameworkConditionAttribute"/> to control which .NET frameworks a test method or test class supports or doesn't support.
+/// </summary>
+[Flags]
+public enum Frameworks
+{
+    /// <summary>
+    /// Represents .NET Framework (the full framework on Windows).
+    /// </summary>
+    NetFramework = 1 << 0,
+
+    /// <summary>
+    /// Represents .NET Core 1.x, 2.x, and 3.x.
+    /// </summary>
+    NetCore = 1 << 1,
+
+    /// <summary>
+    /// Represents .NET 5 and later versions (unified platform).
+    /// </summary>
+    Net = 1 << 2,
+
+    /// <summary>
+    /// Represents Universal Windows Platform (UWP).
+    /// </summary>
+    Uwp = 1 << 3,
+}

src/TestFramework/TestFramework/PublicAPI/PublicAPI.Unshipped.txt

@@ -41,3 +41,14 @@ static Microsoft.VisualStudio.TestTools.UnitTesting.CollectionAssert.Equals(obje
 static Microsoft.VisualStudio.TestTools.UnitTesting.CollectionAssert.ReferenceEquals(object? objA, object? objB) -> bool
 static Microsoft.VisualStudio.TestTools.UnitTesting.StringAssert.Equals(object? objA, object? objB) -> bool
 static Microsoft.VisualStudio.TestTools.UnitTesting.StringAssert.ReferenceEquals(object? objA, object? objB) -> bool
+Microsoft.VisualStudio.TestTools.UnitTesting.Frameworks
+Microsoft.VisualStudio.TestTools.UnitTesting.Frameworks.Net = 4 -> Microsoft.VisualStudio.TestTools.UnitTesting.Frameworks
+Microsoft.VisualStudio.TestTools.UnitTesting.Frameworks.NetCore = 2 -> Microsoft.VisualStudio.TestTools.UnitTesting.Frameworks
+Microsoft.VisualStudio.TestTools.UnitTesting.Frameworks.NetFramework = 1 -> Microsoft.VisualStudio.TestTools.UnitTesting.Frameworks
+Microsoft.VisualStudio.TestTools.UnitTesting.Frameworks.Uwp = 8 -> Microsoft.VisualStudio.TestTools.UnitTesting.Frameworks
+Microsoft.VisualStudio.TestTools.UnitTesting.FrameworkConditionAttribute
+Microsoft.VisualStudio.TestTools.UnitTesting.FrameworkConditionAttribute.FrameworkConditionAttribute(Microsoft.VisualStudio.TestTools.UnitTesting.ConditionMode mode, Microsoft.VisualStudio.TestTools.UnitTesting.Frameworks frameworks) -> void
+Microsoft.VisualStudio.TestTools.UnitTesting.FrameworkConditionAttribute.FrameworkConditionAttribute(Microsoft.VisualStudio.TestTools.UnitTesting.Frameworks frameworks) -> void
+override Microsoft.VisualStudio.TestTools.UnitTesting.FrameworkConditionAttribute.GroupName.get -> string!
+override Microsoft.VisualStudio.TestTools.UnitTesting.FrameworkConditionAttribute.IgnoreMessage.get -> string?
+override Microsoft.VisualStudio.TestTools.UnitTesting.FrameworkConditionAttribute.ShouldRun.get -> bool