{"id":25147,"date":"2019-11-01T20:34:47","date_gmt":"2019-11-01T20:34:47","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/cppblog\/?p=25147"},"modified":"2019-11-01T20:34:47","modified_gmt":"2019-11-01T20:34:47","slug":"an-update-on-cpp-cli-and-dotnet-core","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/cppblog\/an-update-on-cpp-cli-and-dotnet-core\/","title":{"rendered":"An Update on C++\/CLI and .NET Core"},"content":{"rendered":"

The first public release of our C++\/CLI support for .NET Core 3.1 is now available for public preview! It is included in Visual Studio 2019 update 16.4 Preview 2<\/a>. We would love it if you could try it out and send us any feedback you have. For more info about what this is and the roadmap going forward, check out my last post on the future of C++\/CLI and .NET Core<\/a>.<\/p>\n

To get started make sure you have all the necessary components installed. C++\/CLI support for desktop development is an optional component, so you will need to select it on the installer\u2019s right pane:<\/p>\n

\"Install<\/p>\n

You will also need the .NET Core cross-platform development workload. It installs everything you need including the .NET Core 3.1 SDK:<\/p>\n

\"Alt:<\/p>\n

Creating a C++\/CLI .NET Core Project<\/h3>\n

First, you will want to create a \u201cCLR Class Library (.NET Core)\u201d or \u201cCLR Empty Project (.NET Code)\u201d. The Class library template includes some additional boiler plate to set up an example class and precompiled header that may make it easier to get started. The empty project is ideal for bringing in existing C++\/CLI code. Retargeting existing C++\/CLI projects to .NET Core isn\u2019t recommended.<\/p>\n

There isn\u2019t currently a template for C++\/CLI console or Windows applications that can be used with .NET Core. Instead you must put application entry point outside of the C++\/CLI code. In general, we strongly recommend keeping the C++\/CLI projects as narrow in scope as possible to handle just the interoperability between .NET Core and other C++ code.<\/p>\n

\"\"<\/p>\n

Once you create one of these projects, you can reference it from other .NET Core projects like any other class library \u2013 with one important caveat<\/strong>. .NET Core projects are typically architecture agnostic. You see this as the architecture \u201cAny CPU\u201d in the Configuration Manager and \u201cMSIL\u201d in the build logs. This is the default for all .NET Core projects. If you reference any C++\/CLI class libraries, you must specify an explicit architecture for the non-C++ projects instead of \u201cAny CPU\u201d.<\/p>\n

You can set a project\u2019s architecture by using the Configuration Manager<\/a>.<\/p>\n

If the architectures don\u2019t match, you will see this warning and attempting to load the C++\/CLI class library will fail at runtime:<\/p>\n

\"\u201cWarning<\/p>\n

To resolve this, make sure all projects in the solution are using the same architecture of \u201cx86\u201d and \u201cWin32\u201d or \u201cx64\u201d. If you are using ASP.NET Core, there is an additional consideration. Your projects also need to match the architecture of IIS Express. This is typically \u201cx64\u201d. If you see a \u201c500 server error\u201d due to the loader failing, this may be what the problem is.<\/p>\n

Send us Feedback<\/h3>\n

Please try this out. We\u2019d love to hear your feedback\u00a0to\u00a0help us prioritize and\u00a0build the right features. We can be reached via the comments below or email (visualcpp@microsoft.com<\/a>).\u00a0You also can always send us general feedback via Developer Community<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"

The first public release of our C++\/CLI support for .NET Core 3.1 is now available for public preview! It is included in Visual Studio 2019 update 16.4 Preview 2. We would love it if you could try it out and send us any feedback you have. For more info about what this is and the […]<\/p>\n","protected":false},"author":326,"featured_media":25151,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[270],"tags":[86],"class_list":["post-25147","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-announcement","tag-ccli"],"acf":[],"blog_post_summary":"

The first public release of our C++\/CLI support for .NET Core 3.1 is now available for public preview! It is included in Visual Studio 2019 update 16.4 Preview 2. We would love it if you could try it out and send us any feedback you have. For more info about what this is and the […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/25147","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/users\/326"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/comments?post=25147"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/25147\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media\/25151"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media?parent=25147"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/categories?post=25147"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/tags?post=25147"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}