Merge pull request #6070 from MicrosoftDocs/main

Auto Publish – main to live - 2025-09-05 17:30 UTC

Author: learn-build-service-prod[bot]

docs/dotnet/dotnet-programming-with-cpp-cli-visual-cpp.md

@@ -6,6 +6,13 @@ helpviewer_keywords: ["programming [C++], .NET programming", ".NET Framework [C+
 ---
 # .NET programming with C++/CLI
 
+> [!IMPORTANT]
+> C++/CLI is a technology designed during the early years of .NET (2003–2010) and remains supported for compatibility purposes. It's best suited for existing codebases, particularly those being brought forward from .NET Framework to .NET Core, or for maintaining large legacy systems that are unlikely to evolve beyond .NET Framework.
+> 
+> While C++/CLI is reliable and robust, no new feature work is planned beyond what's necessary to ensure continued functionality. Developers should be aware that using C++/CLI pessimizes both C++ and .NET languages, as it's constrained by the language features and APIs available at the time of its design—that is, prior to ISO C++11 and .NET Core. C++/CLI was designed based on C++98, and its [ECMA standard](https://ecma-international.org/publications-and-standards/standards/ecma-372) hasn't been updated to keep up with newer C++ standards since C++11. While some features in C++11 were incorporated, many features from more recent standards, like C++20 and C++23, have no direct support in C++/CLI for compilation to managed code. For more information, see [C++20 Support Comes To C++/CLI](https://devblogs.microsoft.com/cppblog/cpp20-support-comes-to-cpp-cli/).
+> 
+> For new projects, we recommend exploring modern third-party alternatives such as <https://github.com/dotnet/ClangSharp> or <https://www.swig.org/>, which offer more flexibility and better alignment with current language and runtime capabilities.
+
 C++/CLI supplanted Managed C++. C++/CLI is a language specification created by Microsoft that extends C++ to support .NET. It's only supported on Windows. It's not for writing [WinUI](/windows/apps/winui) or Universal Windows Platform [UWP](/windows/uwp/get-started/universal-application-platform-guide) Windows Runtime (WinRT) apps. It's for writing .NET applications and components that run on .NET. C++/CLI is a bridge between native C++ code and managed code. It allows you to use existing C++ libraries in .NET applications and to write new .NET applications in C++.
 
 Microsoft provides C++/WinRT for writing WinUI and WinRT apps. It's an entirely standard modern C++17 language projection for Windows Runtime (WinRT) APIs. For more information about using C++ with the Windows Runtime (WinRT), see [C++/WinRT](/windows/uwp/cpp-and-winrt-apis/).

docs/error-messages/compiler-errors-1/compiler-error-c2322.md

@@ -1,13 +1,14 @@
 ---
-description: "Learn more about: Compiler Error C2322"
 title: "Compiler Error C2322"
-ms.date: "11/04/2016"
+description: "Learn more about: Compiler Error C2322"
+ms.date: 11/04/2016
 f1_keywords: ["C2322"]
 helpviewer_keywords: ["C2322"]
-ms.assetid: f9b92005-618a-42d8-80e9-67ce769a9f3b
 ---
 # Compiler Error C2322
 
-'identifier' : address of dllimport 'dllimport' is not static
+> 'identifier' : address of dllimport 'dllimport' is not static
+
+## Remarks
 
 A nonstatic value is given as the address of a function declared with `dllimport`.

docs/error-messages/compiler-errors-1/compiler-error-c2323.md

@@ -1,16 +1,20 @@
 ---
 title: "Compiler Error C2323"
 description: "Learn more about: Compiler Error C2323"
-ms.date: "03/20/2024"
+ms.date: 03/20/2024
 f1_keywords: ["C2323"]
 helpviewer_keywords: ["C2323"]
 ---
 # Compiler Error C2323
 
-'identifier': non-member operator `new` or `delete` functions may not be declared `static` or in a namespace other than the global namespace.
+> 'identifier': non-member operator `new` or `delete` functions may not be declared `static` or in a namespace other than the global namespace.
+
+## Remarks
 
 The `new` and `delete` overload operators must be non-static, defined in the global namespace or as class members.
 
+## Example
+
 The following generates C2323:
 
 ```cpp

docs/error-messages/compiler-errors-1/compiler-error-c2324.md

@@ -1,18 +1,21 @@
 ---
-description: "Learn more about: Compiler Error C2324"
 title: "Compiler Error C2324"
-ms.date: "11/04/2016"
+description: "Learn more about: Compiler Error C2324"
+ms.date: 11/04/2016
 f1_keywords: ["C2324"]
 helpviewer_keywords: ["C2324"]
-ms.assetid: 215f0544-85b0-452d-825f-17a388b6a61c
 ---
 # Compiler Error C2324
 
-'identifier' : unexpected to the right of 'name'
+> 'identifier' : unexpected to the right of 'name'
+
+## Remarks
 
 A destructor is called using an incorrect identifier.
 
-The following sample generates C2324:
+## Example
+
+The following example generates C2324:
 
 ```cpp
 // C2324.cpp

docs/error-messages/compiler-errors-1/compiler-error-c2325.md

@@ -1,18 +1,21 @@
 ---
-description: "Learn more about: Compiler Error C2325"
 title: "Compiler Error C2325"
-ms.date: "11/04/2016"
+description: "Learn more about: Compiler Error C2325"
+ms.date: 11/04/2016
 f1_keywords: ["C2325"]
 helpviewer_keywords: ["C2325"]
-ms.assetid: e6b0a186-3f2a-4adf-beae-fadd75492bf7
 ---
 # Compiler Error C2325
 
-'type' : unexpected type to the right of 'name'
+> 'type' : unexpected type to the right of 'name'
+
+## Remarks
 
 A call is made to a destructor of incorrect type.
 
-The following sample generates C2325:
+## Example
+
+The following example generates C2325:
 
 ```cpp
 // C2325.cpp

docs/error-messages/compiler-errors-1/compiler-error-c2326.md

@@ -1,20 +1,21 @@
 ---
-description: "Learn more about: Compiler Error C2326"
 title: "Compiler Error C2326"
-ms.date: "11/04/2016"
+description: "Learn more about: Compiler Error C2326"
+ms.date: 11/04/2016
 f1_keywords: ["C2326"]
 helpviewer_keywords: ["C2326"]
-ms.assetid: 01a5ea40-de83-4e6f-a4e8-469f441258e0
 ---
 # Compiler Error C2326
 
-'declarator' : function cannot access 'name'
+> 'declarator' : function cannot access 'name'
+
+## Remarks
 
 The code tries to modify a member variable, which is not possible.
 
 ## Example
 
-The following sample generates C2326:
+The following example generates C2326:
 
 ```cpp
 // C2326.cpp

docs/error-messages/compiler-errors-1/compiler-error-c2327.md

@@ -1,20 +1,23 @@
 ---
-description: "Learn more about: Compiler Error C2327"
 title: "Compiler Error C2327"
-ms.date: "11/04/2016"
+description: "Learn more about: Compiler Error C2327"
+ms.date: 11/04/2016
 f1_keywords: ["C2327"]
 helpviewer_keywords: ["C2327"]
-ms.assetid: 95278c95-d1f9-4487-ad27-53311f5e8112
 ---
 # Compiler Error C2327
 
-'symbol' : is not a type name, static, or enumerator
+> 'symbol' : is not a type name, static, or enumerator
+
+## Remarks
 
 Code within a nested class attempts to access a member of the enclosing class that is not a type name, a static member, or an enumerator.
 
 When compiling with **/clr**, a common cause for C2327 is a property with the same name as the property type.
 
-The following sample generates C2327:
+## Examples
+
+The following example generates C2327:
 
 ```cpp
 // C2327.cpp
@@ -62,7 +65,7 @@ struct B {
 };
 ```
 
-The following sample generates C2327:
+The following example generates C2327:
 
 ```cpp
 // C2327d.cpp
@@ -96,7 +99,7 @@ namespace NA {
 }
 ```
 
-The following sample shows C2327 when a property has the same name as the property type:
+The following example shows C2327 when a property has the same name as the property type:
 
 ```cpp
 // C2327f.cpp

docs/error-messages/compiler-errors-1/compiler-error-c2332.md

@@ -1,18 +1,21 @@
 ---
-description: "Learn more about: Compiler Error C2332"
 title: "Compiler Error C2332"
-ms.date: "11/04/2016"
+description: "Learn more about: Compiler Error C2332"
+ms.date: 11/04/2016
 f1_keywords: ["C2332"]
 helpviewer_keywords: ["C2332"]
-ms.assetid: fb05cd68-e271-4bea-9fb7-ef4edb0a26ac
 ---
 # Compiler Error C2332
 
-'typedef' : missing tag name
+> 'typedef' : missing tag name
+
+## Remarks
 
 The compiler found an incomplete type definition.
 
-The following sample generates C2332:
+## Example
+
+The following example generates C2332:
 
 ```cpp
 // C2332.cpp

docs/error-messages/compiler-errors-1/compiler-error-c2333.md

@@ -1,18 +1,21 @@
 ---
-description: "Learn more about: Compiler Error C2333"
 title: "Compiler Error C2333"
-ms.date: "11/04/2016"
+description: "Learn more about: Compiler Error C2333"
+ms.date: 11/04/2016
 f1_keywords: ["C2333"]
 helpviewer_keywords: ["C2333"]
-ms.assetid: 2636fc1e-d3e7-4e68-8628-3c81a99ba813
 ---
 # Compiler Error C2333
 
-'function' : error in function declaration; skipping function body
+> 'function' : error in function declaration; skipping function body
+
+## Remarks
 
 This error occurs after another error, for member functions defined inside their class.
 
-The following sample generates C2333:
+## Example
+
+The following example generates C2333:
 
 ```cpp
 // C2333.cpp

docs/error-messages/compiler-errors-1/compiler-error-c2334.md

@@ -1,16 +1,17 @@
 ---
-description: "Learn more about: Compiler Error C2334"
 title: "Compiler Error C2334"
-ms.date: "11/04/2016"
+description: "Learn more about: Compiler Error C2334"
+ms.date: 11/04/2016
 f1_keywords: ["C2334"]
 helpviewer_keywords: ["C2334"]
-ms.assetid: 36142855-e00b-4bbf-80f5-a301edeff46e
 ---
 # Compiler Error C2334
 
-unexpected token(s) preceding ': or {'; skipping apparent function body
+> unexpected token(s) preceding ': or {'; skipping apparent function body
+
+## Example
 
-The following sample generates C2334. This error occurs after error C2059:
+The following example generates C2334. This error occurs after error C2059:
 
 ```cpp
 // C2334.cpp