Merge pull request #12894 from dotnet/main

Merge main into live

Author: gewarren

snippets/csharp/System.Reflection.Context/CustomReflectionContext/CustomReflectionContext.Examples.cs

@@ -0,0 +1,97 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Reflection;
+using System.Reflection.Context;
+using Xunit;
+
+namespace System.Reflection.Context.Examples
+{
+    #region Snippet1
+    // A blank example attribute.
+    class MyAttribute : Attribute
+    {
+    }
+
+    // Reflection context with custom rules.
+    class MyCustomReflectionContext : CustomReflectionContext
+    {
+        // Called whenever the reflection context checks for custom attributes.
+        protected override IEnumerable<object> GetCustomAttributes(MemberInfo member, IEnumerable<object> declaredAttributes)
+        {
+            // Add example attribute to "To*" members.
+            if (member.Name.StartsWith("To", StringComparison.Ordinal))
+            {
+                yield return new MyAttribute();
+            }
+            // Keep existing attributes as well.
+            foreach (object attr in declaredAttributes)
+            {
+                yield return attr;
+            }
+        }
+    }
+    #endregion Snippet1
+
+    public class CustomReflectionContextExamples
+    {
+        [Fact]
+        public static void AddCustomAttribute()
+        {
+            #region Snippet2
+            MyCustomReflectionContext mc = new();
+            Type t = typeof(string);
+
+            // A representation of the type in the default reflection context.
+            TypeInfo ti = t.GetTypeInfo();
+
+            // A representation of the type in the customized reflection context.
+            TypeInfo myTI = mc.MapType(ti);
+
+            // Display affected members of the type ("To*") and their attributes.
+            foreach (MemberInfo m in myTI.DeclaredMembers.Where(static m => m.Name.StartsWith("To", StringComparison.Ordinal)))
+            {
+                Console.WriteLine($"{m.Name}:");
+                foreach (Attribute cd in m.GetCustomAttributes())
+                {
+                    Console.WriteLine(cd.GetType());
+                }
+            }
+
+            Console.WriteLine();
+
+            // The "ToString" member as represented in the default reflection context.
+            MemberInfo mi1 = ti.GetDeclaredMethods("ToString").FirstOrDefault();
+
+            Attribute[] defaultAttributes = mi1.GetCustomAttributes().ToArray();
+
+            // All the attributes of "ToString" in the default reflection context.
+            Console.WriteLine("'ToString' Attributes in Default Reflection Context:");
+            foreach (Attribute cd in defaultAttributes)
+            {
+                Console.WriteLine(cd.GetType());
+            }
+
+            Console.WriteLine();
+
+            // The same member in the custom reflection context.
+            mi1 = myTI.GetDeclaredMethods("ToString").FirstOrDefault();
+
+            Attribute[] customAttributes = mi1.GetCustomAttributes().ToArray();
+
+            // All its attributes, for comparison. MyAttribute is now included.
+            Console.WriteLine("'ToString' Attributes in Custom Reflection Context:");
+            foreach (Attribute cd in customAttributes)
+            {
+                Console.WriteLine(cd.GetType());
+            }
+            #endregion Snippet2
+
+            Assert.DoesNotContain(defaultAttributes, attribute => attribute is MyAttribute);
+            Assert.Contains(customAttributes, attribute => attribute is MyAttribute);
+        }
+    }
+}

snippets/csharp/System.Reflection.Context/CustomReflectionContext/Project.csproj

@@ -0,0 +1,13 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="System.Reflection.Context" Version="10.0.10" />
+    <PackageReference Include="xunit.v3" Version="4.0.0-pre.154" />
+  </ItemGroup>
+
+</Project>

snippets/csharp/System.Text.RegularExpressions/Regex/Match/Project.csproj

@@ -0,0 +1,12 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="xunit.v3" Version="4.0.0-pre.154" />
+  </ItemGroup>
+
+</Project>

snippets/csharp/System.Text.RegularExpressions/Regex/Match/Regex.Examples.cs

@@ -0,0 +1,31 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System;
+using System.Text.RegularExpressions;
+using Xunit;
+
+namespace System.Text.RegularExpressions.Examples
+{
+    public class MatchExamples
+    {
+        [Fact]
+        public static void MatchZipCode()
+        {
+            #region Match
+            string input = "Zip code: 98052";
+            var regex = new Regex(@"(?<=Zip code: )\d{5}");
+            Match match = regex.Match(input, 5);
+            if (match.Success)
+                Console.WriteLine($"Match found: {match.Value}");
+
+            // This code prints the following output:
+            //
+            // Match found: 98052
+            #endregion
+
+            Assert.True(match.Success);
+            Assert.Equal("98052", match.Value);
+        }
+    }
+}