IronOCR（OCRソフト）のライセンスキーをWeb.configで設定する方法

更新日:2025年6月9日

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.config ファイルに保存されたキーは、製品によって取得および使用されません。

回避策

この問題に対処するには、コード内でConfigurationManagerを使用して Web.config ファイルからライセンスキーを取得し、それを 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.Configuration;

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

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

using System.Configuration;

// Retrieve the license key from the Web.config'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
Private 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,571,678 | バージョン: 2026.4 リリース