Merge pull request #12199 from dotnet/main

Merge main into live

Author: dotnet-policy-service[bot]

snippets/csharp/System.Diagnostics.Tracing/EventAttribute/Overview/etwtrace.csproj

@@ -2,7 +2,7 @@
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
-    <TargetFramework>netcoreapp5.0</TargetFramework>
+    <TargetFramework>net10.0</TargetFramework>
   </PropertyGroup>
 
-</Project>
+</Project>

snippets/visualbasic/System.Diagnostics.Tracing/EventAttribute/Overview/etwtrace.vbproj

@@ -0,0 +1,8 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net10.0</TargetFramework>
+  </PropertyGroup>
+
+</Project>

snippets/visualbasic/System.Diagnostics.Tracing/EventAttribute/Overview/program.vb

@@ -6,7 +6,7 @@ Enum MyColor
     Red
     Yellow
     Blue
-End Enum 'MyColor 
+End Enum 'MyColor
 <EventSource(Name:="MyCompany")> _
 Class MyCompanyEventSource
     Inherits EventSource
@@ -117,4 +117,4 @@ Class Program
         '</Snippet13>
     End Sub
 End Class
-'</Snippet1>
+'</Snippet1>

xml/System.Diagnostics.Tracing/EventAttribute.xml

@@ -54,19 +54,19 @@
   <Docs>
     <summary>Defines the standard keywords that apply to events.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- You can customize the meaning of a keyword by assigning different names to the flags.  
-  
-   
-  
-## Examples  
- The following example shows how to use the <xref:System.Diagnostics.Tracing.EventKeywords> class to redefine event keywords. This code example is part of a larger example provided for the <xref:System.Diagnostics.Tracing.EventSource> class.  
-  
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+ You can customize the meaning of a keyword by assigning different names to the flags.
+
+
+
+## Examples
+ The following example shows how to use the <xref:System.Diagnostics.Tracing.EventKeywords> class to redefine event keywords.  This code example is part of a larger example provided for the [EventSource](/dotnet/fundamentals/runtime-libraries/system-diagnostics-tracing-eventsource#examples) class.
+
  :::code language="csharp" source="~/snippets/csharp/System.Diagnostics.Tracing/EventAttribute/Overview/program.cs" id="Snippet3":::
- :::code language="vb" source="~/snippets/visualbasic/System.Diagnostics.Tracing/EventAttribute/Overview/program.vb" id="Snippet3":::  
-  
+ :::code language="vb" source="~/snippets/visualbasic/System.Diagnostics.Tracing/EventAttribute/Overview/program.vb" id="Snippet3":::
+
  ]]></format>
     </remarks>
   </Docs>

xml/System.Diagnostics.Tracing/EventKeywords.xml

@@ -48,29 +48,26 @@
   <Docs>
     <summary>Identifies the level of an event.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
-## Remarks  
- The level signifies the severity of an event. Lower severity levels encompass higher severity levels. For example, `Warning` includes the `Error` and `Critical` levels, which are higher in severity.  
-  
-   
-  
-## Examples  
+      <format type="text/markdown"><![CDATA[
+
+The level signifies the severity of an event. Lower severity levels encompass higher severity levels. For example, `Warning` includes the `Error` and `Critical` levels, which are higher in severity.
+
+## Examples
 
 The following example shows how to use the `Error` enumeration member to identify an error message. This example is part of a larger example provided for the <xref:System.Diagnostics.Tracing.EventSource> class.
-  
+
  :::code language="csharp" source="~/snippets/csharp/System.Diagnostics.Tracing/EventAttribute/Overview/program.cs" id="Snippet5":::
- :::code language="vb" source="~/snippets/visualbasic/System.Diagnostics.Tracing/EventAttribute/Overview/program.vb" id="Snippet5":::  
+ :::code language="vb" source="~/snippets/visualbasic/System.Diagnostics.Tracing/EventAttribute/Overview/program.vb" id="Snippet5":::
+
+The following example shows how to use the `Informational` enumeration member to identify an informational message. This example is part of a larger example provided for the <xref:System.Diagnostics.Tracing.EventSource> class.
 
-The following example shows how to use the `Informational` enumeration member to identify an informational message. This example is part of a larger example provided for the <xref:System.Diagnostics.Tracing.EventSource> class.  
-  
  :::code language="csharp" source="~/snippets/csharp/System.Diagnostics.Tracing/EventAttribute/Overview/program.cs" id="Snippet6":::
- :::code language="vb" source="~/snippets/visualbasic/System.Diagnostics.Tracing/EventAttribute/Overview/program.vb" id="Snippet6":::  
+ :::code language="vb" source="~/snippets/visualbasic/System.Diagnostics.Tracing/EventAttribute/Overview/program.vb" id="Snippet6":::
+
+The following example shows how to use the `Verbose` enumeration member to identify a verbose message. This example is part of a larger example provided for the <xref:System.Diagnostics.Tracing.EventSource> class.
 
-The following example shows how to use the `Verbose` enumeration member to identify a verbose message. This example is part of a larger example provided for the <xref:System.Diagnostics.Tracing.EventSource> class.  
-  
  :::code language="csharp" source="~/snippets/csharp/System.Diagnostics.Tracing/EventAttribute/Overview/program.cs" id="Snippet11":::
- :::code language="vb" source="~/snippets/visualbasic/System.Diagnostics.Tracing/EventAttribute/Overview/program.vb" id="Snippet11":::  
+ :::code language="vb" source="~/snippets/visualbasic/System.Diagnostics.Tracing/EventAttribute/Overview/program.vb" id="Snippet11":::
 
  ]]></format>
     </remarks>

xml/System.Diagnostics.Tracing/EventLevel.xml

@@ -48,17 +48,17 @@
   <Docs>
     <summary>Defines the standard operation codes that the event source attaches to events.</summary>
     <remarks>
-      <format type="text/markdown"><![CDATA[  
-  
+      <format type="text/markdown"><![CDATA[
+
 ## Examples
 
-The following example shows how to use the `Start` enumeration member to specify a start operation. This example is part of a larger example provided for the <xref:System.Diagnostics.Tracing.EventSource> class.
-  
+The following example shows how to use the `Start` enumeration member to specify a start operation.  This code example is part of a larger example provided for the [EventSource](/dotnet/fundamentals/runtime-libraries/system-diagnostics-tracing-eventsource#examples) class.
+
 :::code language="csharp" source="~/snippets/csharp/System.Diagnostics.Tracing/EventAttribute/Overview/program.cs" id="Snippet7":::
-:::code language="vb" source="~/snippets/visualbasic/System.Diagnostics.Tracing/EventAttribute/Overview/program.vb" id="Snippet7":::  
-  
-The following example shows how to use the `Stop` enumeration member to specify a stop operation. This example is part of a larger example provided for the <xref:System.Diagnostics.Tracing.EventSource> class.  
-  
+:::code language="vb" source="~/snippets/visualbasic/System.Diagnostics.Tracing/EventAttribute/Overview/program.vb" id="Snippet7":::
+
+The following example shows how to use the `Stop` enumeration member to specify a stop operation.  This code example is part of a larger example provided for the [EventSource](/dotnet/fundamentals/runtime-libraries/system-diagnostics-tracing-eventsource#examples) class.
+
 :::code language="csharp" source="~/snippets/csharp/System.Diagnostics.Tracing/EventAttribute/Overview/program.cs" id="Snippet8":::
 :::code language="vb" source="~/snippets/visualbasic/System.Diagnostics.Tracing/EventAttribute/Overview/program.vb" id="Snippet8":::