ASP.NET Core 總覽

  • 發行項

由 Daniel Roth、Rick Anderson 和 Shaun Luttin 提供

ASP.NET Core 是一種跨平臺、高效能的開放原始碼架構，可用於建立現代化、具備雲端功能的網際網路連線應用程式。

利用 ASP.NET Core，您可以：

  • 建立 web 應用程式和服務、 物聯網 (IoT) 應用程式和行動後端。
  • 在 Windows、macOS 和 Linux 上使用您最愛的開發工具。
  • 部署到雲端或在內部部署。
  • 在 .Net Core上執行。

為什麼要選擇 ASP.NET Core？

數百萬位開發人員使用或使用ASP.NET 4.x 來建立 web 應用程式。 ASP.NET Core 是 ASP.NET 4.x 的重新設計，包括會產生更精簡、更模組化架構的架構變更。

ASP.NET Core 提供下列優點：

  • 用於建置 Web UI 和 Web API 的統一劇本。
  • 可測試性架構。
  • Razor 頁面讓編碼頁面導向的案例更容易且更具生產力。
  • Blazor 可讓您在瀏覽器中使用 c # 與 JavaScript。 共用伺服器端與用戶端應用程式邏輯都是以 .NET 撰寫。
  • 能夠在 Windows、macOS 和 Linux 上開發並執行。
  • 開放原始碼和以 社區為焦點的。
  • 整合 新式客戶 端架構和開發工作流程。
  • 支援使用 gRPC來裝載遠端程序呼叫 (RPC) 服務。
  • 雲端就緒、以環境為基礎的組態系統。
  • 內建的相依性插入。
  • 輕量、 高效能且模組化的 HTTP 要求管線。
  • 能夠在下列情況下裝載：
  • 並存版本控制。
  • 可簡化現代網頁程式開發的工具。

使用 ASP.NET Core MVC 建置 Web API 和 Web UI

ASP.NET Core MVC 提供了建置 Web API 和 Web 應用程式的功能：

用戶端開發

ASP.NET Core 與熱門用戶端架構和程式庫緊密整合，包括 Blazor 、 Angular、 React和啟動程式。 如需詳細資訊，請參閱用戶端開發的ASP.NET Core Blazor和相關主題。

ASP.NET Core 目標 framework

ASP.NET Core 3.x 和更新版本只能以 .net Core 為目標。 一般來說，ASP.NET Core 是由.NET Standard程式庫所組成。 使用 .NET Standard 2.0 撰寫的程式庫可在任何實作 .NET Standard 2.0 的 .NET 平台上執行。

將目標指向 .NET Core 有多個好處，而這些好處也隨著版本更新越來越多。 NET Core 較 .NET Framework 多的好處包含：

  • 跨平台。 在 Windows、macOS 和 Linux 上執行。
  • 提升效能
  • 並存版本控制
  • 新的 API
  • 開放原始碼

針對開發 ASP.NET Core 應用程式的簡介，我們建議使用下列一系列的教學課程：

  1. 遵循您想要開發或維護之應用程式類型的教學課程。

    應用程式類型 案例 教學課程
    Web 應用程式 新的伺服器端 web UI 開發 Razor開始頁面
    Web 應用程式 維護 MVC 應用程式 開始使用 MVC
    Web 應用程式 用戶端 web UI 開發 開始Blazor
    Web API RESTful HTTP 服務 建立 WEB API†
    遠端程序呼叫應用程式 使用通訊協定緩衝區的合約優先服務 開始使用 gRPC 服務
    即時應用程式 伺服器和連線用戶端之間的雙向通訊 開始SignalR

  2. 遵循示範如何進行基本資料存取的教學課程。

    案例 教學課程
    新開發 Razor 具有 Entity Framework Core 的頁面
    維護 MVC 應用程式 搭配 Entity Framework Core 的 MVC

  3. 閱讀適用于所有應用程式類型的 ASP.NET Core基礎概念總覽。

  4. 流覽目錄以尋找感興趣的其他主題。

†也有 互動式 WEB API 教學課程。 不需要本機安裝開發工具。 程式碼會在您瀏覽器中的Azure Cloud Shell中執行，並使用捲曲來進行測試。

從 .NET Framework 遷移

如需將 ASP.NET 4.x 應用程式遷移至 ASP.NET Core 的參考指南，請參閱從 ASP.NET 遷移至 ASP.NET Core。

ASP.NET Core 是一種跨平臺、高效能的開放原始碼架構，可用於建立現代化、具備雲端功能的網際網路連線應用程式。 利用 ASP.NET Core，您可以：

  • 建立 web 應用程式和服務、 物聯網 (IoT) 應用程式和行動後端。
  • 在 Windows、macOS 和 Linux 上使用您最愛的開發工具。
  • 部署到雲端或在內部部署。
  • 在 .NET Core 或 .NET Framework 上執行。

為什麼要選擇 ASP.NET Core？

數百萬位開發人員使用或使用ASP.NET 4.x 來建立 web 應用程式。 ASP.NET Core 是 ASP.NET 4.x 的重新設計，其架構變更可產生更為精簡且更加模組化的架構。

ASP.NET Core 提供下列優點：

  • 用於建置 Web UI 和 Web API 的統一劇本。
  • 可測試性架構。
  • Razor 頁面讓編碼頁面導向的案例更容易且更具生產力。
  • Blazor 可讓您在瀏覽器中使用 c # 與 JavaScript。 共用伺服器端與用戶端應用程式邏輯都是以 .NET 撰寫。
  • 能夠在 Windows、macOS 和 Linux 上開發並執行。
  • 開放原始碼和以 社區為焦點的。
  • 整合 新式客戶 端架構和開發工作流程。
  • 支援使用 gRPC來裝載遠端程序呼叫 (RPC) 服務。
  • 雲端就緒、以環境為基礎的組態系統。
  • 內建的相依性插入。
  • 輕量、 高效能且模組化的 HTTP 要求管線。
  • 能夠在下列情況下裝載：
  • 並存版本控制。
  • 可簡化現代網頁程式開發的工具。

使用 ASP.NET Core MVC 建置 Web API 和 Web UI

ASP.NET Core MVC 提供了建置 Web API 和 Web 應用程式的功能：

用戶端開發

ASP.NET Core 與熱門用戶端架構和程式庫緊密整合，包括 Blazor 、 Angular、 React和啟動程式。 如需詳細資訊，請參閱用戶端開發的ASP.NET Core Blazor和相關主題。

將目標指向 .NET Framework 的 ASP.NET Core

ASP.NET Core 2.x 的目標可以是 NET Core 或 .NET Framework。 ASP.NET Core 以 .NET Framework 為目標的應用程式不是跨平臺，只會在 Windows 上執行。 ASP.NET Core 2.x 通常會包含 .NET Standard 程式庫。 使用 .NET Standard 2.0 撰寫的程式庫可在任何實作 .NET Standard 2.0 的 .NET 平台上執行。

實作 .NET Standard 2.0 的 .NET Framework 版本支援 ASP.NET Core 2.x：

  • 建議使用 .NET Framework 最新版本。
  • .NET Framework 4.6.1 和更新版本。

ASP.NET Core 3.0 及更新版本只可在.NET Core 上執行。 如需此變更的詳細資料，請參閱A first look at changes coming in ASP.NET Core 3.0 (搶先看 ASP.NET Core 3.0 的變更)。

將目標指向 .NET Core 有多個好處，而這些好處也隨著版本更新越來越多。 NET Core 較 .NET Framework 多的好處包含：

  • 跨平台。 可在 macOS、Linux 及 Windows 上執行。
  • 提升效能
  • 並存版本控制
  • 新的 API
  • 開放原始碼

為了協助您從 .NET Framework 到 .net core 來關閉 API 間距， Windows 相容性套件提供了數千個僅適用于 .net core 的 Windows api。 這些 API 並不適用於 .NET Core 1.x。

我們建議遵循一系列的教學課程和文章，取得開發 ASP.NET Core 應用程式的簡介：

  1. 遵循您想要開發或維護的應用程式類型的教學課程。

    應用程式類型 案例 教學課程
    Web 應用程式 針對全新開發 Razor開始頁面
    Web 應用程式 針對維護 MVC 應用程式 開始使用 MVC
    Web API 建立 WEB API†
    即時應用程式 開始SignalR

  2. 遵循示範如何進行基本資料存取的教學課程。

    案例 教學課程
    針對全新開發 Razor 具有 Entity Framework Core 的頁面
    針對維護 MVC 應用程式 搭配 Entity Framework Core 的 MVC

  3. 閱讀適用于所有應用程式類型的 ASP.NET Core基礎概念總覽。

  4. 瀏覽其他您感興趣主題的目錄。

您也有一個 WEB API 教學課程，您可以完全在瀏覽器中執行，而不需要本機 IDE 安裝。 程式碼會在 Azure Cloud Shell 中執行，且會使用 curl 來進行測試。

從 .NET Framework 遷移

如需將 ASP.NET 應用程式遷移至 ASP.NET Core 的參考指南，請參閱從 ASP.NET 遷移至 ASP.NET Core。

如何下載範例

許多文章及教學課程都有包含範例程式碼的連結。

  1. 下載 ASP.NET 存放庫 ZIP 檔案。
  2. 將 AspNetCore.Docs-main.zip 檔案解壓縮。
  3. 若要存取解壓縮存放庫中的文章範例應用程式，請使用本文範例連結中的 URL，以協助您流覽至範例的資料夾。 文章的範例連結通常會出現在文章頂端，內含連結文字 視圖或下載範例程式碼。

範例程式碼中的前置處理器指示詞

為了示範多個案例，範例應用程式會使用 #define 和 #if-#else/#elif-#endif 預處理器指示詞，選擇性地編譯及執行範例程式碼的不同區段。 針對使用這種方法的範例，請在 c # 檔案頂端設定 #define 指示詞，以定義與您想要執行的情節相關聯的符號。 某些範例需要在多個檔案的頂端定義符號，才能執行案例。

例如下列 #define 符號清單指出其提供四個情節 (每個符號一個情節)。 目前的範例設定會執行 TemplateCode 情節：

#define TemplateCode // or LogFromMain or ExpandDefault or FilterInCode

若要變更此範例，以執行 ExpandDefault 情節，請定義 ExpandDefault 符號，並將剩餘的符號設為註解：

#define ExpandDefault // TemplateCode or LogFromMain or FilterInCode

如需如何使用 C# 前置處理器指示詞，以選擇編譯不同之程式碼區段的詳細資訊，請參閱 #define (C# 參考) 及 #if (C# 參考)。

範例程式碼中的區域

某些範例應用程式包含 #region 和 #endregion c # 指示詞所括住的程式碼區段。 文件建置系統會將這些區域插入轉譯的文件主題中。

區功能變數名稱稱通常會包含 "程式碼片段" 這個字。下列範例顯示名為 snippet_WebHostDefaults 的區域：

#region snippet_WebHostDefaults
Host.CreateDefaultBuilder(args)
    .ConfigureWebHostDefaults(webBuilder =>
    {
        webBuilder.UseStartup<Startup>();
    });
#endregion

上述的 C# 程式碼片段會在主題的 Markdown 檔案中，透過以下程式行加以參考：

[!code-csharp[](sample/SampleApp/Program.cs?name=snippet_WebHostDefaults)]

您可以放心地忽略 (或移除程式碼) 的 #region 和 #endregion 指示詞。 如果您打算執行主題中所述的範例案例，請不要改變這些指示詞內的程式碼。 您可以在試驗其他案例時自由改變程式碼。

如需詳細資訊，請參閱 Contribute to the ASP.NET documentation: Code snippets (參與 ASP.NET 文件：程式碼片段)。

重大變更和資訊安全諮詢

公告存放庫中會報告重大變更和資訊安全摘要報告。 您可以藉由選取 標籤 篩選器，將宣告限制為特定版本。

後續步驟

如需詳細資訊，請參閱下列資源：