Skip to content

Add clarification that hosting APIs require framework-dependent deployments #49595

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
+3 −0
Open

Add clarification that hosting APIs require framework-dependent deployments #49595

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
c3a60c9
Initial plan
Copilot Nov 3, 2025
c76e270
Add clarification about hosting API limitations with single-file depl…
Copilot Nov 3, 2025
9c857e6
Update hosting API note per review feedback
Copilot Nov 3, 2025
66fcb95
Update hosting API deployment model explanation
agocke Nov 4, 2025
13bd545
Apply suggestion from @Copilot
AaronRobinsonMSFT Nov 4, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions docs/core/tutorials/netcore-hosting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,9 @@ You also need to build a .NET component to test the host with, so you should ins

Hosting the .NET runtime is done with the `nethost` and `hostfxr` libraries' APIs. These entry points handle the complexity of finding and setting up the runtime for initialization and allow both launching a managed application and calling into a static managed method.

> [!IMPORTANT]
> The `nethost` and `hostfxr` hosting APIs only support framework-dependent deployments. Self-contained deployments should be treated as stand-alone executables. If you're evaluating deployment models for your application, use a framework-dependent deployment to ensure compatibility with these native hosting APIs.

## Create a host using `nethost.h` and `hostfxr.h`

A [sample host](https://github.com/dotnet/samples/tree/main/core/hosting) demonstrating the steps outlined in the tutorial below is available in the dotnet/samples GitHub repository. Comments in the sample clearly associate the numbered steps from this tutorial with where they're performed in the sample. For download instructions, see [Samples and Tutorials](../../samples-and-tutorials/index.md#view-and-download-samples).
Expand Down