From c1bd9d45d5702db1cadb19c3f02e98daa79f2928 Mon Sep 17 00:00:00 2001 From: Bill Wagner Date: Mon, 18 Nov 2024 11:45:56 -0500 Subject: [PATCH] Fix markdown lint warnings These are new warnings that will be introduced in #43611 Pre-emptively fix them. --- ...-args-cause-argumentoutofrangeexception.md | 1 + .../null-args-cause-argumentnullexception.md | 1 + ...-owner-causes-invalidoperationexception.md | 1 + docs/framework/whats-new/obsolete-members.md | 30 +++++++++++++++++++ .../code-analysis/quality-rules/index.md | 1 + .../code-analysis/style-rules/index.md | 1 + .../base-types/regular-expressions.md | 2 ++ 7 files changed, 37 insertions(+) diff --git a/docs/core/compatibility/windows-forms/5.0/invalid-args-cause-argumentoutofrangeexception.md b/docs/core/compatibility/windows-forms/5.0/invalid-args-cause-argumentoutofrangeexception.md index 27b4b0c12300c..8fa1c9ffec3c8 100644 --- a/docs/core/compatibility/windows-forms/5.0/invalid-args-cause-argumentoutofrangeexception.md +++ b/docs/core/compatibility/windows-forms/5.0/invalid-args-cause-argumentoutofrangeexception.md @@ -27,6 +27,7 @@ Throwing an conforms to the behavior o The following table lists the affected properties and parameters: > [!div class="mx-tdBreakAll"] +> > | Property | Parameter name | Version added | > |-|-|-| > | | `index` | 5.0 Preview 5 | diff --git a/docs/core/compatibility/windows-forms/5.0/null-args-cause-argumentnullexception.md b/docs/core/compatibility/windows-forms/5.0/null-args-cause-argumentnullexception.md index 74523e2bce03b..82baaa0e26d75 100644 --- a/docs/core/compatibility/windows-forms/5.0/null-args-cause-argumentnullexception.md +++ b/docs/core/compatibility/windows-forms/5.0/null-args-cause-argumentnullexception.md @@ -26,6 +26,7 @@ If you call any of these methods and your code currently catches a [!div class="mx-tdBreakAll"] +> > | Method | Parameter name | Version added | > |-|-|-| > | | `owner` | Preview 1 | diff --git a/docs/core/compatibility/windows-forms/5.0/null-owner-causes-invalidoperationexception.md b/docs/core/compatibility/windows-forms/5.0/null-owner-causes-invalidoperationexception.md index 5df9aea970ce0..367db85c56774 100644 --- a/docs/core/compatibility/windows-forms/5.0/null-owner-causes-invalidoperationexception.md +++ b/docs/core/compatibility/windows-forms/5.0/null-owner-causes-invalidoperationexception.md @@ -28,6 +28,7 @@ Review your code and, if necessary, update it to prevent constructing the affect The following table lists the affected APIs: > [!div class="mx-tdBreakAll"] +> > | Affected method or property | Validated property | Version added | > |-|-|-| > | | | 5.0 | diff --git a/docs/framework/whats-new/obsolete-members.md b/docs/framework/whats-new/obsolete-members.md index 82f85a7c3337e..ce13e27a1e621 100644 --- a/docs/framework/whats-new/obsolete-members.md +++ b/docs/framework/whats-new/obsolete-members.md @@ -16,6 +16,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## mscorlib.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||The registry key only works on Win9x, which is no longer supported by the CLR. On NT-based operating systems, use the registry key or the registry proxy instead.| @@ -182,6 +183,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## PresentationCore.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||Bitmap effects are deprecated and no longer function. Consider using where appropriate instead.| @@ -222,6 +224,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## PresentationFramework.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||Replaced by .| @@ -232,6 +235,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## System.Activities.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||First deprecated in the .NET Framework 4.5.

Don't use this constructor. Use or instead.| @@ -240,6 +244,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## System.Activities.Presentation.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||This method doesn't support dragging multiple items.| @@ -255,6 +260,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## System.Core.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||First deprecated in the .NET Framework 4.5.

Incorrect value; use instead.| @@ -298,6 +304,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## System.Data.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > ||| has been deprecated.| @@ -320,6 +327,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## System.Data.Entity.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||This property is going away, Use the property instead.| @@ -330,6 +338,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## System.Data.OracleClient.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > ||| has been deprecated. Use the classes to explicitly set the precision of a decimal.| @@ -339,6 +348,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## System.Design.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||This method has been deprecated. Use instead.| @@ -392,6 +402,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## System.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||Callers should not use the interface and should instead use the methods directly on the class.| @@ -504,6 +515,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## System.Drawing.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||Don't use the method; use the property instead.| @@ -512,6 +524,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## System.Messaging.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||This method returns a that implements the family of methods incorrectly. Use instead.| @@ -520,6 +533,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## System.ServiceModel.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||First deprecated in the .NET Framework 4.5.

This property is obsolete. To enable Http , use the property instead.| @@ -532,6 +546,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## System.ServiceModel.Discovery.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||First deprecated in the .NET Framework 4.5.

The property is obsolete. Consider using for setting the transport properties.| @@ -540,6 +555,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## System.Web.DataVisualization.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > ||| has been deprecated. Investigate instead.| @@ -547,6 +563,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## System.Web.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||The recommended alternative is in System.Web.dll.| @@ -582,6 +599,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## System.Web.DynamicData.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||Use the `EnablePersistedSelection` property on a databound control such as or .| @@ -589,6 +607,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## System.Web.Extensions.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||Use .| @@ -603,6 +622,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## System.Web.Services.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||This method will be removed from a future version. The method call is no longer required for resource discovery.| @@ -611,6 +631,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## System.Windows.Forms.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||This enumeration value has been deprecated. There is no replacement.| @@ -628,6 +649,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## System.Xaml.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||This isn't used by the XAML parser. See .| @@ -636,6 +658,7 @@ This article doesn't list the members of obsolete types. For a list of obsolete ## System.Xml.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||Validation type should be specified as or .| @@ -662,6 +685,7 @@ The IEHost.dll and IEExec.exe assemblies have been removed from .NET Framework. ## ISymWrapper.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||The recommended alternative is . takes the importer interface pointer as an instead of an , and thus works on both 32-bit and 64-bit architectures.| @@ -669,6 +693,7 @@ The IEHost.dll and IEExec.exe assemblies have been removed from .NET Framework. ## Microsoft.Build.Conversion.v4.0.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||Use parameterless overload instead.| @@ -679,6 +704,7 @@ The IEHost.dll and IEExec.exe assemblies have been removed from .NET Framework. ## Microsoft.Build.Engine.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||Avoid setting . If you were simply passing in the .NET Framework location as the , no other action is necessary. Otherwise, define Toolsets instead in the registry or config file, or by adding elements to the Engine's , to use a custom .| @@ -687,6 +713,7 @@ The IEHost.dll and IEExec.exe assemblies have been removed from .NET Framework. ## Microsoft.Build.Framework.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||First deprecated in the .NET Framework 4.5.

Use of this member generates a compiler error.

Use the property instead.| @@ -694,6 +721,7 @@ The IEHost.dll and IEExec.exe assemblies have been removed from .NET Framework. ## Microsoft.Build.Utilities.v4.0.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||Use the property.| @@ -701,6 +729,7 @@ The IEHost.dll and IEExec.exe assemblies have been removed from .NET Framework. ## Microsoft.Data.Entity.Build.Tasks.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |`Microsoft.Data.Entity.Build.Tasks.EntityDeploy`|`EntityDataModelEmbeddedResources`|First deprecated in the .NET Framework 4.5.

Used only for version 3.5 backward compatibility.| @@ -708,6 +737,7 @@ The IEHost.dll and IEExec.exe assemblies have been removed from .NET Framework. ## Microsoft.VisualBasic.dll > [!div class="mx-tdBreakAll"] +> > |Type|Member|Message| > |----------|------------|-------------| > |||This member has been deprecated. Use to write types, or coerce `FileNumber` and `RecordNumber` to for writing non-object types.| diff --git a/docs/fundamentals/code-analysis/quality-rules/index.md b/docs/fundamentals/code-analysis/quality-rules/index.md index 4531ca666b575..63d99e07ea866 100644 --- a/docs/fundamentals/code-analysis/quality-rules/index.md +++ b/docs/fundamentals/code-analysis/quality-rules/index.md @@ -12,6 +12,7 @@ ms.date: 01/31/2024 The following table lists code quality analysis rules. > [!div class="mx-tdCol2BreakAll"] +> > | Rule ID and warning | Description | > | ------------------- | ----------- | > | [CA1000: Do not declare static members on generic types](ca1000.md) | When a static member of a generic type is called, the type argument must be specified for the type. When a generic instance member that does not support inference is called, the type argument must be specified for the member. In these two cases, the syntax for specifying the type argument is different and easily confused. | diff --git a/docs/fundamentals/code-analysis/style-rules/index.md b/docs/fundamentals/code-analysis/style-rules/index.md index bb81fb3071163..a8fc4df699509 100644 --- a/docs/fundamentals/code-analysis/style-rules/index.md +++ b/docs/fundamentals/code-analysis/style-rules/index.md @@ -32,6 +32,7 @@ The code-style rules are organized into the following subcategories: The following table list all the code-style rules by ID and [options](../code-style-rule-options.md), if any. > [!div class="mx-tdCol3BreakAll"] +> > | Rule ID | Title | Option | > | - | - | - | > | [IDE0001](ide0001.md) | Simplify name | | diff --git a/docs/standard/base-types/regular-expressions.md b/docs/standard/base-types/regular-expressions.md index 331ce730967dd..9b2b18ef0b387 100644 --- a/docs/standard/base-types/regular-expressions.md +++ b/docs/standard/base-types/regular-expressions.md @@ -88,6 +88,7 @@ The class includes string search and replacement methods th The regular expression pattern `\b(\w+?)\s\1\b` can be interpreted as follows: > [!div class="mx-tdCol2BreakAll"] +> > |Pattern|Interpretation| > |-|-| > |`\b`|Start at a word boundary.| @@ -110,6 +111,7 @@ The class includes string search and replacement methods th On a computer whose current culture is English - United States (en-US), the example dynamically builds the regular expression `\$\s*[-+]?([0-9]{0,3}(,[0-9]{3})*(\.[0-9]+)?)`. This regular expression pattern can be interpreted as follows: > [!div class="mx-tdCol2BreakAll"] +> > |Pattern|Interpretation| > |-|-| > |`\$`|Look for a single occurrence of the dollar symbol (`$`) in the input string. The regular expression pattern string includes a backslash to indicate that the dollar symbol is to be interpreted literally rather than as a regular expression anchor. The `$` symbol alone would indicate that the regular expression engine should try to begin its match at the end of a string. To ensure that the current culture's currency symbol isn't misinterpreted as a regular expression symbol, the example calls the method to escape the character.|