C# (.NET)

概述

用于开发基于C#和.NET的应用程序。包含所有必要的SDK、扩展和依赖项。

有关已发布镜像内容的信息，请参见历史记录。

使用本镜像

你可以通过在.devcontainer/devcontainer.json中使用image属性，或在自己的Dockerfile中更新FROM语句来直接引用预构建的Dockerfile版本。本仓库中包含示例Dockerfile。

• mcr.microsoft.com/devcontainers/dotnet（最新版）
• mcr.microsoft.com/devcontainers/dotnet:9.0（或9.0-bookworm、9.0-noble以固定OS版本）
• mcr.microsoft.com/devcontainers/dotnet:8.0（或8.0-bookworm、8.0-noble、8.0-focal以固定OS版本）

有关更多详情，请参考此指南。

你可以通过引用每个镜像的语义化版本来决定更新频率。例如：

• mcr.microsoft.com/devcontainers/dotnet:1-9.0
• mcr.microsoft.com/devcontainers/dotnet:1.3-9.0
• mcr.microsoft.com/devcontainers/dotnet:1.3.0-9.0

有关每个版本内容的信息，请参见历史记录，完整标签列表。

或者，你可以使用.devcontainer中的内容来完全自定义容器内容，或为镜像不支持的容器主机架构构建容器。

使用自定义开发证书在ASP.NET中启用HTTPS

要在ASP.NET中启用HTTPS，你可以挂载本地开发证书的导出副本。

1. 使用以下命令导出证书：

   Windows PowerShell

   powershell
   dotnet dev-certs https --trust; dotnet dev-certs https -ep "$env:USERPROFILE/.aspnet/https/aspnetapp.pfx" -p "SecurePwdGoesHere"
   

   macOS/Linux终端

   powershell
   dotnet dev-certs https --trust; dotnet dev-certs https -ep "${HOME}/.aspnet/https/aspnetapp.pfx" -p "SecurePwdGoesHere"
   

2. 在devcontainer.json中添加以下内容：

   json
   "remoteEnv": {
       "ASPNETCORE_Kestrel__Certificates__Default__Password": "SecurePwdGoesHere",
       "ASPNETCORE_Kestrel__Certificates__Default__Path": "/home/vscode/.aspnet/https/aspnetapp.pfx",
   }
   

3. 最后，按以下方式使证书在容器中可用：

   在devcontainer.json中添加：

   json
   "mounts": [ "source=${env:HOME}${env:USERPROFILE}/.aspnet/https,target=/home/vscode/.aspnet/https,type=bind" ]
   

安装Node.js或Azure CLI

由于与ASP.NET后端配合使用的JavaScript前端Web客户端代码通常需要使用基于Node.js的工具进行构建，此容器还包含nvm，以便你可以轻松安装Node.js。

如果你想安装Azure CLI，可以通过在devcontainer.json中添加以下内容来引用开发容器功能：

json
{
  "features": {
    "ghcr.io/devcontainers/features/azure-cli:1": {
      "version": "latest"
    }
  }
}

支持

开发容器规范镜像在devcontainers/images仓库中维护。你可以浏览每个镜像并提交问题或功能请求。

许可证

版权所有 (c) Microsoft Corporation。保留所有权利。

根据MIT许可证授权。参见LICENSE。