Merge pull request #68 from CommunityToolkit/dev/stack-trace-hidden-attribute

Add [StackTraceHidden] attribute to Diagnostics package

Author: Sergio0694

CommunityToolkit.Diagnostics/Attributes/StackTraceHiddenAttribute.cs

@@ -0,0 +1,23 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+// See the LICENSE file in the project root for more information.
+
+#if !NET6_0_OR_GREATER
+
+namespace System.Diagnostics;
+
+/// <summary>
+/// Removes annotated methods from the stacktrace in case an exception occurrs while they're on the stack.
+/// </summary>
+/// <remarks>
+/// This is a port of the attribute from the BCL in .NET 6, and it's marked as conditional so that it will
+/// be removed for package builds that are released on NuGet. This attribute is only used internally to
+/// avoid having to clutter the codebase with many compiler directive switches to check for this API.
+/// </remarks>
+[Conditional("DEBUG")]
+[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method | AttributeTargets.Constructor | AttributeTargets.Struct, Inherited = false)]
+internal sealed class StackTraceHiddenAttribute : Attribute
+{
+}
+
+#endif

CommunityToolkit.Diagnostics/Internals/Guard.ThrowHelper.cs

@@ -3,6 +3,7 @@
 // See the LICENSE file in the project root for more information.
 
 using System;
+using System.Diagnostics;
 using System.Diagnostics.CodeAnalysis;
 
 namespace CommunityToolkit.Diagnostics;
@@ -15,6 +16,7 @@ public static partial class Guard
     /// <summary>
     /// Helper methods to efficiently throw exceptions.
     /// </summary>
+    [StackTraceHidden]
     private static partial class ThrowHelper
     {
         /// <summary>