1. IronXL
  2. 開始使用
  3. 使用授權金鑰

Using IronXL License Keys

Curtis Chau
Curtis Chau
更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

如何取得授權金鑰

添加 IronXL 授權金鑰後，您即可無限制且無浮水印地將專案部署至生產環境。

您可在此購買授權金鑰，或註冊免費 30天試用金鑰。

步驟 1：下載 IronXL 最新版本

我們首先需要安裝 IronXl.Excel 程式庫，為 .NET Framework 增添 Excel 功能。

透過 NuGet 套件安裝

  1. 在 Visual Studio 中，右鍵點擊專案並選擇"管理 NuGet 套件..."
  2. 搜尋 IronXl.Excel 套件並安裝

或

  1. 開啟套件管理員主控台

  2. 類型：

    Install-Package IronXL.Excel

請在此處瀏覽 NuGet 網站上的套件。

DLL 直接下載安裝

Download the IronXL [.NET Excel DLL]() and manually install it into Visual Studio.

步驟 2：套用您的授權金鑰

請在您的程式碼中設定授權金鑰

請將此程式碼加入應用程式的啟動部分，位於使用 IronXL 之前。

// Set the IronXL license key for your project
IronXl.License.LicenseKey = "IRONXL-MYLICENSE-KEY-1EF01";
// Set the IronXL license key for your project
IronXl.License.LicenseKey = "IRONXL-MYLICENSE-KEY-1EF01";
' Set the IronXL license key for your project
IronXl.License.LicenseKey = "IRONXL-MYLICENSE-KEY-1EF01"
$vbLabelText   $csharpLabel

在 .NET Framework 應用程式中，請透過 Web.Co/nfig 或 App.Co/nfig 設定您的金鑰

若要透過 Web.Co/nfig 或 App.Co/nfig 在應用程式中全域套用某個金鑰，請在 appSettings 中的設定檔中加入以下金鑰。

<configuration>
  ...
  <appSettings>

    <add key="IronXl.LicenseKey" value="IRONXL-MYLICENSE-KEY-1EF01"/>
  </appSettings>
  ...
</configuration>
<configuration>
  ...
  <appSettings>

    <add key="IronXl.LicenseKey" value="IRONXL-MYLICENSE-KEY-1EF01"/>
  </appSettings>
  ...
</configuration>
XML

IronXL 版本 2023.4.13 至 2024.3.20 在專案中存在已知的授權問題：

  • ASP.NET 專案
  • .NET Framework 版本 >= 4.6.2

儲存在 Web.co/nfig 檔案中的金鑰並未被產品讀取並使用。 請參閱"在 Web.co/nfig 中設定授權金鑰"的疑難排解文章以了解更多資訊。

請確保 IronXl.License.IsLicensed 會返回 true 以供驗證。

請使用 .NET Core 的 appsettings.json 檔案設定您的金鑰

要在您的 .NET Core 應用程式中將金鑰套用至全域範圍：

  • 在專案的根目錄中，新增一個名為 appsettings.json 的 JSON 檔案
  • 請在您的 JSON 設定檔中新增一個 'IronXl.LicenseKey' 鍵。其值應為您的授權金鑰。
  • 請確保檔案屬性中包含"複製至輸出目錄：始終複製"
  • 請確保 IronXl.License.IsLicensed 會返回 true 以供驗證。

檔案：appsettings.json

{
  "IronXl.LicenseKey": "IRONXL-MYLICENSE-KEY-1EF01"
}

步驟 3：測試您的關鍵字

請測試您的金鑰是否已正確安裝。

// Check if a given license key string is valid.
bool result = IronXl.License.IsValidLicense("IRONXL-MYLICENSE-KEY-1EF01");

// Check if IronXL is licensed successfully
bool is_licensed = IronXl.License.IsLicensed;
// Check if a given license key string is valid.
bool result = IronXl.License.IsValidLicense("IRONXL-MYLICENSE-KEY-1EF01");

// Check if IronXL is licensed successfully
bool is_licensed = IronXl.License.IsLicensed;
Imports IronXl

' Check if a given license key string is valid.
Dim result As Boolean = License.IsValidLicense("IRONXL-MYLICENSE-KEY-1EF01")

' Check if IronXL is licensed successfully
Dim is_licensed As Boolean = License.IsLicensed
$vbLabelText   $csharpLabel

注意：新增授權後，請務必清理並重新發佈您的應用程式，以避免部署時可能出現的錯誤。

步驟 4：開始您的專案

請參閱我們的教學指南，了解如何開始使用 IronXL。

有任何問題嗎？

如有任何疑問，請聯繫 support@ironsoftware.com

常見問題

我該如何為我的專案取得授權金鑰？

您可透過 IronXL 網站購買授權金鑰，或註冊免費 30天試用版來取得授權金鑰。

使用 NuGet 套件管理員安裝 IronXL 的步驟為何？

若要透過 NuGet 套件管理員安裝 IronXL，請開啟 Visual Studio，在專案上按右鍵，選擇「管理 NuGet 套件...」，搜尋 IronXL.Excel 並進行安裝。您亦可使用套件管理員控制台輸入 Install-Package IronXL.Excel 來執行安裝。

如何透過 DLL 手動安裝 IronXL？

您可以透過從 IronXL 網站下載 .NET Excel DLL 並將其加入 Visual Studio 專案中，手動安裝 IronXL。

我該如何在應用程式程式碼中套用我的授權金鑰？

請使用以下方式將授權金鑰加入應用程式的啟動程式碼中：IronXl.License.LicenseKey = "您的授權金鑰"。

如何在 .NET Framework 應用程式的 Web.Config 檔案中設定授權金鑰？

您可在 Web.Config 檔案的 appSettings 區段中，透過新增以下內容來設定授權金鑰：。

IronXL 的特定版本是否存在已知的授權問題？

是的，IronXL 版本 2023.4.13 至 2024.3.20 在 ASP.NET 專案及 .NET Framework 4.6.2 及以上版本中存在已知問題，系統可能無法識別儲存於 Web.config 中的金鑰。

如何在 .NET Core 應用程式中透過 appsettings.json 套用我的授權金鑰？

在您的 .NET Core 應用程式中，新增一個名為 appsettings.json 的 JSON 檔案，加入包含您的授權金鑰的 'IronXl.LicenseKey' 項目，並將檔案屬性設定為 '複製到輸出目錄：始終複製'。

如何確認我的 IronXL 授權金鑰是否已正確套用？

若要驗證您的授權金鑰，請使用 IronXl.License.IsValidLicense("您的授權金鑰") 檢查其有效性，並確保 IronXl.License.IsLicensed 返回 true。

新增授權金鑰後應採取哪些步驟？

新增授權金鑰後，務必清理並重新發佈您的應用程式，以避免部署問題。

我該去哪裡尋找額外的協助或支援？

如需進一步協助或支援，請透過 support@ironsoftware.com 聯絡 Iron Software 支援團隊。

IronXL 的授權是否完全支援 .NET 10 專案與平台？

是的。IronXL 的產品（包括透過程式碼、Web.Config 或 appsettings.json 進行授權）在 .NET 10 上（以及 .NET 9、8、7、6 及 .NET Core / Standard / Framework 各版本）均獲得完整支援，無需特殊設定。要在 .NET 10 中套用授權金鑰，請使用官方文件中所述的相同方法：在啟動程式碼中設定 IronXl.License.LicenseKey，或使用 appsettings.json 等設定檔，將 "IronXl.LicenseKey": "YOUR-KEY" 寫入其中，並確保該檔案已複製至輸出目錄。此做法符合 IronXL 的相容性聲明。（[ironsoftware.com](https://ironsoftware.com/csharp/excel/?utm_source=openai)）

Curtis Chau
Curtis Chau
  立即與工程團隊聯繫
技術撰稿人

Curtis Chau 擁有卡爾頓大學（Carleton University）的電腦科學學士學位，專精於前端開發，並精通 Node.js、TypeScript、JavaScript 及 React。他熱衷於打造直觀且美觀的用戶介面，喜歡運用現代框架，並創建結構完善、視覺上吸引人的手冊。

除了開發工作之外，Curtis 對物聯網（IoT）抱有濃厚興趣，致力於探索整合硬體與軟體的創新方法。閒暇時，他喜歡玩遊戲和開發 Discord 機器人，將對科技的熱愛與創意相結合。

準備開始了嗎？
Nuget 下載 2,052,917 | 版本： 2026.6 just released
Still Scrolling Icon

還在捲動嗎？

想要快速證明？ PM > Install-Package IronXL.Excel
執行範例 觀看您的資料變成試算表。