Merge pull request #12638 from dotnet/main

Merge main into live

Author: gewarren

.github/policies/disallow-edits.yml

@@ -70,6 +70,9 @@ configuration:
               - filesMatchPattern:
                   matchAny: true
                   pattern: xml/System.Text.RegularExpressions/*
+              - filesMatchPattern:
+                  matchAny: true
+                  pattern: xml/System.Threading.RateLimiting/*
         then:
             - addReply:
                 reply: >-

docfx.json

@@ -175,6 +175,7 @@
         "api/System.Numerics.Tensors.**": false,
         "api/System.Reflection.Context.**": false,
         "api/System.Text.RegularExpressions.**": false,
+        "api/System.Threading.RateLimiting.**": false,
 
         "api/System.Diagnostics.FileVersionInfo.yml": false,
         "api/System.Linq.AsyncEnumerable.yml": false,

xml/Microsoft.CSharp/CSharpCodeProvider.xml

@@ -40,18 +40,6 @@
 
 This class provides methods that can be used to retrieve instances of the C# <xref:System.CodeDom.Compiler.ICodeGenerator> and <xref:System.CodeDom.Compiler.ICodeCompiler> implementations.
 
-> [!NOTE]
-> This class contains a link demand and an inheritance demand at the class level that applies to all members. A <xref:System.Security.SecurityException> is thrown when either the immediate caller or the derived class does not have full-trust permission.
-
-## Examples
- The following example uses either the C# or Visual Basic code provider to compile a source file. The example checks the input file extension and uses the corresponding <xref:Microsoft.CSharp.CSharpCodeProvider> or <xref:Microsoft.VisualBasic.VBCodeProvider> for compilation. The input file is compiled into an executable file, and any compilation errors are displayed to the console.
-
-> [!IMPORTANT]
-> The `CompileAssemblyFrom*` methods aren't supported on .NET Core and .NET 5+. This example only runs on .NET Framework.
-
- :::code language="csharp" source="~/snippets/csharp/Microsoft.CSharp/CSharpCodeProvider/Overview/source.cs" id="Snippet1":::
- :::code language="vb" source="~/snippets/visualbasic/Microsoft.CSharp/CSharpCodeProvider/Overview/source.vb" id="Snippet1":::
-
  ]]></format>
     </remarks>
     <altmember cref="T:System.CodeDom.Compiler.ICodeGenerator" />
@@ -134,32 +122,6 @@ This class provides methods that can be used to retrieve instances of the C# <xr
         <remarks>
           <format type="text/markdown"><![CDATA[
 
-## Remarks
-
-In .NET Framework apps, you can obtain the value for `providerOptions` from the [\<providerOption>](/dotnet/framework/configure-apps/file-schema/compiler/provideroption-element) element in the configuration file. You can identify the version of the <xref:Microsoft.CSharp.CSharpCodeProvider> you want to use by specifying the `<providerOption>` element, supplying "CompilerVersion" as the option name, and supplying the version number (for example, "v3.5") as the option value.  You must precede the version number with a lower case "v". The following configuration file example demonstrates how to specify that version 3.5 of the C# code provider should be used.
-
-```xml
-<configuration>
-  <system.codedom>
-    <compilers>
-      <!-- zero or more compiler elements -->
-      <compiler
-        language="c#;cs;csharp"
-        extension=".cs"
-        type="Microsoft.CSharp.CSharpCodeProvider, System,
-          Version=2.0.3600.0, Culture=neutral,
-          PublicKeyToken=b77a5c561934e089"
-        compilerOptions="/optimize"
-        warningLevel="1" >
-          <providerOption
-            name="CompilerVersion"
-            value="v3.5" />
-      </compiler>
-    </compilers>
-  </system.codedom>
-</configuration>
-```
-
 ## Examples
 
  The following example shows how to specify the compiler version when you create a new instance of the <xref:Microsoft.CSharp.CSharpCodeProvider> class.
@@ -172,10 +134,7 @@ In .NET Framework apps, you can obtain the value for `providerOptions` from the
           <paramref name="providerOptions" /> is <see langword="null" />.</exception>
         <altmember cref="T:System.CodeDom.Compiler.CompilerInfo" />
         <altmember cref="T:System.CodeDom.Compiler.CodeDomProvider" />
-        <related type="Article" href="/dotnet/framework/configure-apps/file-schema/">Configuration file schema for the .NET Framework</related>
-        <related type="Article" href="/dotnet/framework/configure-apps/file-schema/compiler/compilers-element">&lt;compilers&gt; Element</related>
         <related type="Article" href="/dotnet/fundamentals/reflection/specifying-fully-qualified-type-names">Specifying Fully Qualified Type Names</related>
-        <related type="Article" href="/dotnet/framework/configure-apps/file-schema/compiler/provideroption-element">&lt;provideroption&gt; Element</related>
       </Docs>
     </Member>
     <Member MemberName="CreateCompiler">
@@ -358,10 +317,8 @@ In .NET Framework apps, you can obtain the value for `providerOptions` from the
 ## Remarks
  Members are generated differently depending on their context. For example, a method in an interface or a field in an enumeration is generated differently than a method or field on a class.  This implementation generates code for a member in the class context.
 
-
-
 ## Examples
- The following code example shows the use of the <xref:Microsoft.CSharp.CSharpCodeProvider.GenerateCodeFromMember*> method to create a code fragment to be used in a CodeDOM graph. This code example is part of a larger example provided for the <xref:System.CodeDom.Compiler.CodeDomProvider.GenerateCodeFromMember*> method of the <xref:System.CodeDom.Compiler.CodeDomProvider> class.
+ The following code example shows the use of the <xref:Microsoft.CSharp.CSharpCodeProvider.GenerateCodeFromMember*> method to create a code fragment to be used in a CodeDOM graph.
 
  :::code language="csharp" source="~/snippets/csharp/Microsoft.CSharp/CSharpCodeProvider/GenerateCodeFromMember/program.cs" id="Snippet3":::
  :::code language="vb" source="~/snippets/visualbasic/Microsoft.CSharp/CSharpCodeProvider/GenerateCodeFromMember/module1.vb" id="Snippet3":::

xml/Microsoft.Win32.SafeHandles/SafeHandleMinusOneIsInvalid.xml

@@ -57,7 +57,7 @@
  This class derives from the <xref:System.Runtime.InteropServices.SafeHandle?displayProperty=nameWithType> class. It describes the format of an invalid handle that uses a value of -1. Further derivations of this class (for example, file or registry handles) can specialize this further. See the <xref:Microsoft.Win32.SafeHandles.SafeFileHandle> class for an example of a class that derives from <xref:Microsoft.Win32.SafeHandles.SafeHandleMinusOneIsInvalid>.
 
 > [!WARNING]
-> This type implements the <xref:System.IDisposable> interface. When you have finished using the type, you should dispose of it either directly or indirectly. To dispose of the type directly, call its <xref:System.IDisposable.Dispose*> method in a `try`-`catch` block. To dispose of it indirectly, use a language construct such as `using` (in C#) or `Using` (in Visual Basic). For more information, see the "Using an Object that Implements IDisposable" section in the <xref:System.IDisposable> interface topic.
+> This type implements the <xref:System.IDisposable> interface. When you have finished using the type, you should dispose of it either directly or indirectly. To dispose of the type directly, call its <xref:System.IDisposable.Dispose*> method in a `try`-`catch` block. To dispose of it indirectly, use a language construct such as `using` in C#.
 
  ]]></format>
     </remarks>

xml/Microsoft.Win32/FileDialog.xml

@@ -813,7 +813,7 @@ Open and save file dialog boxes have a **Favorite Links** panel on the left side
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
- This value is the <xref:Microsoft.Win32.FileDialog.FileName*> with all path information removed. Removing the paths makes the value appropriate for use in partial trust applications, since it prevents applications from discovering information about the local file system.
+ This value is the <xref:Microsoft.Win32.FileDialog.FileName*> with all path information removed. Removing the paths prevents applications from discovering information about the local file system.
 
  If more than one file name is selected (length of <xref:Microsoft.Win32.FileDialog.SafeFileNames*> is greater than one) then this property contains only the first selected file name.
 

xml/Microsoft.Win32/OpenFileDialog.xml

@@ -171,7 +171,7 @@ You cannot declare this managed class in XAML.
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
- The file is opened with read-only permission (<xref:System.IO.FileMode.Open>, <xref:System.IO.FileAccess.Read>, and <xref:System.IO.FileShare.Read>), whether or not the Read Only checkbox is checked in the dialog. Because the file is opened without the ability to overwrite or write to the file, an application can safely load a file while executing within partial trust restrictions.
+ The file is opened with read-only permission (<xref:System.IO.FileMode.Open>, <xref:System.IO.FileAccess.Read>, and <xref:System.IO.FileShare.Read>), whether or not the Read Only checkbox is checked in the dialog.
 
  If more than one file is selected, the first selected file is opened.
 
@@ -211,7 +211,7 @@ You cannot declare this managed class in XAML.
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
- Each file is opened with read-only permission (<xref:System.IO.FileMode.Open>, <xref:System.IO.FileAccess.Read>, and <xref:System.IO.FileShare.Read>), whether or not the Read Only checkbox is checked in the dialog. Because each file is opened without the ability to overwrite or write to the file, an application can safely load one or more files while executing within partial trust restrictions.
+ Each file is opened with read-only permission (<xref:System.IO.FileMode.Open>, <xref:System.IO.FileAccess.Read>, and <xref:System.IO.FileShare.Read>), whether or not the Read Only checkbox is checked in the dialog.
 
  ]]></format>
         </remarks>