ライセンスの組み込み

作成する .NET Framework アプリケーションに、本製品のライセンスを組み込む方法について説明します。

licenses.licx ファイルの組み込み

設計時にコントロールをフォームに貼り付けると licenses.licx ファイルが自動的に作成され、プロジェクトに組み込まれます。しかし、実行時にコントロールを生成する場合は、licenses.licx ファイルは作成されません。

この場合は、該当するすべてのコントロールの情報を含んだ licenses.licx ファイルを作成し、プロジェクトに組み込む必要があります。プロジェクトに licenses.licx ファイルが組み込まれていない場合は、実行時にコントロールが生成されたときに、ライセンスのエラーを示すダイアログが表示されます。

licenses.licx ファイルの作成とプロジェクトへの組み込みは、以下の手順で行います。

1. Visual Studioで新しいプロジェクトを開きます。

2. JPAddressの次のコンポーネントを参照設定します。

   コンポーネント名	バージョン
   GrapeCity.Windows.JPAddress	4.0.48xx.2017

3. Visual Basic のプロジェクトの場合は「My Project」フォルダ、C# のプロジェクトの場合は「Properties」フォルダの下に、ファイル名を「licenses.licx」とした空のテキストファイルを作成します。

4. 作成した「licenses.licx」ファイルを開き、以下の文字列をlicenses.licxに入力します。

   GrapeCity.Windows.JPAddress.GcJPAddress, GrapeCity.Windows.JPAddress, Version=4.0.48xx.2017, Culture=neutral, PublicKeyToken=0ba7528ecf28c40a

5. プロパティウィンドウで licenses.licx のビルドアクションを「埋め込みリソース」に設定して保存します。

継承コントロールとユーザーコントロール

JPAddress のコントロールを継承して独自のコントロールを作成したり、JPAddress のコンポーネントと他のコントロールを組み合わせてユーザーコントロールを作成する場合は、LicenseProvider 属性をそれらのコントロールに設定してください。これにより、JPAddress のライセンス情報が正しく継承されます。

LicenseProvider 属性を設定しなかった場合は、JPAddress のライセンス情報を参照できないので、作成したコントロールを使ったアプリケーションを実行したときに、ライセンスのエラーを示すダイアログが表示されます。

コントロールに LicenseProvider 属性を設定するには、次のように、クラスの宣言の前に LicenseProvider 属性を設定します。

using System.ComponentModel;

// 継承コントロールの場合
[LicenseProviderAttribute(typeof(LicenseProvider))]
public partial class MyControl : GrapeCity.Windows.JPAddress
{
    ・・・
}

// ユーザーコントロールの場合
[LicenseProviderAttribute(typeof(LicenseProvider))]
public partial class UserControl1 : UserControl
{
    ・・・
}

Imports System.ComponentModel

' 継承コントロールの場合
<LicenseProviderAttribute(GetType(LicenseProvider))>_
Public Class MyControl
    ・・・
End Class

' ユーザーコントロールの場合
<LicenseProviderAttribute(GetType(LicenseProvider))>_
Public Class UserControl1
    ・・・
End Class

他のアセンブリからの利用

JPAddress をクラスライブラリなどで使用し、他のアセンブリからクラスライブラリを通して再利用する場合、呼び出し元のプロジェクトにも JPAddress のライセンスが必要です。この場合、コントロールを動的に作成した場合と同じように呼び出し元のプロジェクトに licenses.licx ファイルの組み込みを行う必要があります。

複数のプロジェクトを使用している場合、最初に実行されるプロジェクト（アセンブリ）にライセンス情報が必要である点に注意してください。