Add "Remarks" and "Example" headings for error references in range [C2581, C2610]

Rageking8 · web-flow · commit 1fcc773c753e · 2025-08-01T18:20:03.000+08:00
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2581.md b/docs/error-messages/compiler-errors-2/compiler-error-c2581.md
@@ -10,6 +10,8 @@ ms.assetid: 24a4e4c1-24d3-4e42-b760-7dcaf9740b16
 
 > 'type' : static 'operator =' function is illegal
 
+## Remarks
+
 The assignment (`=`) operator is incorrectly declared as **`static`**. Assignment operators cannot be **`static`**. For more information, see [User-Defined Operators (C++/CLI)](../../dotnet/user-defined-operators-cpp-cli.md).
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2582.md b/docs/error-messages/compiler-errors-2/compiler-error-c2582.md
@@ -10,8 +10,12 @@ ms.assetid: ee1b9378-8bcd-4792-b87e-6d7a466d29ed
 
 > 'function' function is unavailable in 'type'
 
+## Remarks
+
 An attempt was made to assign to an object that does not have an assignment operator.
 
+## Example
+
 The following sample generates C2582:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2584.md b/docs/error-messages/compiler-errors-2/compiler-error-c2584.md
@@ -10,6 +10,8 @@ ms.assetid: 836e2c0a-86c0-4742-b432-beb0191ad20e
 
 > 'Class' : direct base 'Base2' is inaccessible; already a base of 'Base1'
 
+## Remarks
+
 `Class` already derives directly from `Base1`. `Base2` also derives from `Base1`. `Class` cannot derive from `Base2` because that would mean inheriting (indirectly) from `Base1` again, which is not legal because `Base1` is already a direct base class.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2585.md b/docs/error-messages/compiler-errors-2/compiler-error-c2585.md
@@ -10,6 +10,8 @@ ms.assetid: 05bb1a9c-28fb-4a88-a1b5-aea85ebdee1c
 
 > explicit conversion to 'type' is ambiguous
 
+## Remarks
+
 The type conversion can produce more than one result.
 
 ### To fix by checking the following possible causes
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2586.md b/docs/error-messages/compiler-errors-2/compiler-error-c2586.md
@@ -10,8 +10,12 @@ ms.assetid: dae703c7-5c38-4db6-8411-4d1b22713eb5
 
 > incorrect user-defined conversion syntax : illegal indirections
 
+## Remarks
+
 Indirection of a conversion operator is not allowed.
 
+## Example
+
 The following sample generates C2586:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2587.md b/docs/error-messages/compiler-errors-2/compiler-error-c2587.md
@@ -10,8 +10,12 @@ ms.assetid: 7637a2c7-35d4-4b5a-a8f2-515a7bda98fd
 
 > 'identifier' : illegal use of local variable as default parameter
 
+## Remarks
+
 Local variables are not allowed as default parameters.
 
+## Example
+
 The following sample generates C2587:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2588.md b/docs/error-messages/compiler-errors-2/compiler-error-c2588.md
@@ -10,10 +10,14 @@ ms.assetid: 19a0cabd-ca13-44a5-9be3-ee676abf9bc4
 
 > '::~identifier' : illegal global destructor
 
+## Remarks
+
 The destructor is defined for something other than a class, structure, or union. This is not allowed.
 
 This error can be caused by a missing class, structure, or union name on the left side of the scope resolution (`::`) operator.
 
+## Example
+
 The following sample generates C2588:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2589.md b/docs/error-messages/compiler-errors-2/compiler-error-c2589.md
@@ -10,10 +10,14 @@ ms.assetid: 1d7942c7-8a81-4bb4-b272-76a0019e8513
 
 > 'identifier' : illegal token on right side of '::'
 
+## Remarks
+
 If a class, structure, or union name appears to the left of the scope-resolution operator (double colons), the token on the right must be a class, structure, or union member. Otherwise, any global identifier can appear on the right.
 
 The scope-resolution operator cannot be overloaded.
 
+## Example
+
 The following sample generates C2589:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2592.md b/docs/error-messages/compiler-errors-2/compiler-error-c2592.md
@@ -10,4 +10,6 @@ ms.assetid: 833a4d7b-66ef-4d4c-ae83-a533c2b0eb07
 
 > 'class': 'base_class_2' is inherited from 'base_class_1' and cannot be re-specified
 
+## Remarks
+
 You can only specify base classes that do not inherit from other base classes. In this case, only `base_class_1` is needed in the specification of **`class`** because `base_class_1` already inherits `base_class_2`.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2593.md b/docs/error-messages/compiler-errors-2/compiler-error-c2593.md
@@ -10,10 +10,14 @@ ms.assetid: 4a0fe9bb-2163-447d-91f6-1890ed8250f6
 
 > 'operator identifier' is ambiguous
 
+## Remarks
+
 More than one possible operator is defined for an overloaded operator.
 
 This error may be fixed if you use an explicit cast on one or more actual parameters.
 
+## Examples
+
 The following sample generates C2593:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2594.md b/docs/error-messages/compiler-errors-2/compiler-error-c2594.md
@@ -10,8 +10,12 @@ ms.assetid: 68cd708f-266e-44b0-a211-3e3ab63b11bf
 
 > 'operator' : ambiguous conversions from 'type1' to 'type2'
 
+## Remarks
+
 No conversion from *type1* to *type2* was more direct than any other. We suggest two possible solutions to converting from *type1* to *type2*. The first option is to define a direct conversion from *type1* to *type2*, and the second option is to specify a sequence of conversions from *type1* to *type2*.
 
+## Example
+
 The following sample generates C2594. The suggested resolution to the error is a sequence of conversions:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2597.md b/docs/error-messages/compiler-errors-2/compiler-error-c2597.md
@@ -10,6 +10,8 @@ ms.assetid: 2e48127d-e3ff-4a40-8156-2863e45b1a38
 
 > illegal reference to non-static member 'identifier'
 
+## Remarks
+
 Possible causes:
 
 1. A nonstatic member is specified in a static member function. To access the nonstatic member, you must pass in or create a local instance of the class and use a member-access operator (`.` or `->`).
@@ -18,6 +20,8 @@ Possible causes:
 
 1. A member access operator refers to a nonmember function.
 
+## Example
+
 1. The following sample generates C2597 and shows how to fix it:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2598.md b/docs/error-messages/compiler-errors-2/compiler-error-c2598.md
@@ -10,8 +10,12 @@ ms.assetid: 40777c62-39ba-441e-b081-f49f94b43547
 
 > linkage specification must be at global scope
 
+## Remarks
+
 The linkage specifier is declared at local scope.
 
+## Example
+
 The following sample generates C2598:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2599.md b/docs/error-messages/compiler-errors-2/compiler-error-c2599.md
@@ -10,10 +10,14 @@ ms.assetid: 88515f36-7589-47e2-862e-0de8b18d6668
 
 > 'enum' : forward declaration of enum type is not allowed
 
+## Remarks
+
 The compiler no longer supports forward declaration of a managed enumeration.
 
 Forward declaration of an enum type is not allowed under [/Za](../../build/reference/za-ze-disable-language-extensions.md).
 
+## Example
+
 The following sample generates C2599:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2600.md b/docs/error-messages/compiler-errors-2/compiler-error-c2600.md
@@ -10,10 +10,14 @@ ms.assetid: cce11943-ea01-4bee-a7b0-b67d24ec6493
 
 > 'function' : cannot define a compiler-generated special member function (must be declared in the class first)
 
+## Remarks
+
 Before member functions such as constructors or destructors can be defined for a class, they must be declared in the class. The compiler can generate default constructors and destructors (called special member functions) if none are declared in the class. However, if you define one of these functions without a matching declaration in the class, the compiler detects a conflict.
 
 To fix this error, in the class declaration, declare each member function that you define outside the class declaration.
 
+## Example
+
 The following sample generates C2600:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2602.md b/docs/error-messages/compiler-errors-2/compiler-error-c2602.md
@@ -10,8 +10,12 @@ ms.assetid: 6c07a40e-537e-4954-b5c5-1e0e58fe1952
 
 > 'class::Identifier' is not a member of a base class of 'class'
 
+## Remarks
+
 `Identifier` cannot be accessed because it is not a member inherited from any base class.
 
+## Example
+
 The following sample generates C2602:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2603.md b/docs/error-messages/compiler-errors-2/compiler-error-c2603.md
@@ -10,6 +10,8 @@ ms.assetid: 9ca520d0-f082-4b65-933d-17c3bcf8b02c
 
 > '*function*' : Too many block scope static objects with constructor/destructors in function
 
+## Remarks
+
 In versions of the Microsoft C++ compiler before Visual Studio 2015, or when the [/Zc:threadSafeInit-](../../build/reference/zc-threadsafeinit-thread-safe-local-static-initialization.md) compiler option is specified, there is a limit of 31 on the number of static objects you can have in an externally visible inline function.
 
 To resolve this issue, we recommend you adopt more recent version of the Microsoft C++ compiler toolset, or if possible, remove the /Zc:threadSafeInit- compiler option. If this is not possible, consider combining your static objects. If the objects are of the same type, consider use of a single static array of that type, and reference individual members as required.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2605.md b/docs/error-messages/compiler-errors-2/compiler-error-c2605.md
@@ -10,6 +10,8 @@ ms.assetid: a0e6f132-5acf-4e19-b277-ddf196d182bf
 
 > 'name' : this method is reserved within a managed or WinRT class
 
+## Remarks
+
 Certain names are reserved by the compiler for internal functions.  For more information, see [Destructors and finalizers](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers).
 
 ## Example
