Web.co/nfig でのライセンスキーの設定

更新日:2026年4月21日

Translated

View the article in English

この問題は、IronOCR バージョン 2024.3.4 以降で解決されています。

Exception: Unhandled exception. IronSoftware.Exceptions.LicensingException: IronOCR must be licensed for development.

旧バージョンのIronOCR（具体的にはバージョン2023.4.13から2024.3.4の間）において、以下の点で既知のライセンス上の問題があります：

ASP.NET プロジェクト
.NET Framework バージョン 4.6.2 以上

Web.co/nfig ファイルに保存されたキーは、本製品によって取得・使用されることはありません。

回避策

この問題に対処するには、コード内でConfigurationManagerを使用してWeb.co/nfigファイルからライセンスキーを取得し、それをLicense.LicenseKeyプロパティに適用することを推奨します。

例：

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

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

XML

上記のXMLファイルを使用すれば、ConfigurationManagerを利用してライセンスキーの値を取得し、それをIronOcr.License.LicenseKeyプロパティに渡すことができます。

using System.Co/nfiguration;

// Retrieve the license key from the Web.co/nfig's appSettings
string licenseKey = ConfigurationManager.AppSettings["IronOcr.LicenseKey"];

// Apply the license key to IronOcr to avoid licensing exceptions
IronOcr.License.LicenseKey = licenseKey;

using System.Co/nfiguration;

// Retrieve the license key from the Web.co/nfig's appSettings
string licenseKey = ConfigurationManager.AppSettings["IronOcr.LicenseKey"];

// Apply the license key to IronOcr to avoid licensing exceptions
IronOcr.License.LicenseKey = licenseKey;

Imports System.Configuration

' Retrieve the license key from the Web.config's appSettings
Dim licenseKey As String = ConfigurationManager.AppSettings("IronOcr.LicenseKey")

' Apply the license key to IronOcr to avoid licensing exceptions
IronOcr.License.LicenseKey = licenseKey

$vbLabelText $csharpLabel

カーティス・チャウ

今すぐエンジニアリングチームとチャット

テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT（Internet of Things）への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はできましたか？

Nuget ダウンロード 5,896,332 | バージョン: 2026.5 just released