ライセンスの組み込み

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

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

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

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

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

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

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

コンポーネント名	バージョン
GrapeCity.Framework.InputMan	2.4.40xx.2012
GrapeCity.Win.Editors	10.0.40xx.2012

40xx.2012は、製品アセンブリバージョンによって変わります。アセンブリバージョンについては、「アセンブリ」をご覧ください。

.NET Coreプロジェクトで使用する場合は、プロジェクトの参照設定に追加するのではなく、NuGetパッケージをインストールします。詳細は「プロジェクトの作成とアセンブリ参照の追加」をご参照ください。

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

.NET Coreプロジェクトで使用する場合は、プロジェクト配下の任意の場所に licenses.licxファイルを追加します。

作成した「Licenses.licx」ファイルを開き、以下の文字列から該当するコントロールに関するものを選んで、Licenses.licx に入力します。

GrapeCity.Win.Editors.GcTextBox, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcMask, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcMaskedComboBox, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcCharMask, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcDateTime, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcDate, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcTime, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcTimeSpan, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcNumber, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcRichTextBox, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcComboBox, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcListBox, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcPostal, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcAddressBox, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcSoftKeyboard, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcIme, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcShortcut, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcAddress, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcCommonValidator, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcDateTimeValidator, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcDateValidator, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcTimeValidator, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcTimeSpanValidator, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcNumberValidator, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12
GrapeCity.Win.Editors.GcFieldStyler, GrapeCity.Win.Editors.v100, Version=10.0.40xx.2012, Culture=neutral, PublicKeyToken=0ce01a33ce55ca12

10.0.40xx.2012は、製品アセンブリバージョンによって変わります。アセンブリバージョンについては、「アセンブリ」をご覧ください。

.NET Coreプロジェクトで使用する場合は、上記の一覧にある「GrapeCity.Win.Editors.v100」の部分を「GrapeCity.Win.Editors.NetCore.v100」に変更します。

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

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

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

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

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

Visual Basic
C#

Imports System.Drawing
Imports System.Windows.Forms
Imports System.ComponentModel

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

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

using System.Drawing;
using System.Windows.Forms;
using System.ComponentModel;

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

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

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

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

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

参照

はじめに