.NET アセンブリのロード

.NET アセンブリは、タイプ、メタデータ、プログラムコードのパッケージです。.NET アプリケーションでは、すべてのコードがアセンブリになければなりません。アセンブリファイルの拡張子は .dll または .exe です。

アセンブリには、次の種類があります。

プライベートアセンブリ ファイルシステム内のファイル。
共有アセンブリ グローバルアセンブリキャッシュにインストールされるアセンブリ。

Mobile Link では、クラスを含むアセンブリが指定されないと、クラスをロードしてそのクラスのメソッドを呼び出すことができません。指定する必要があるのは、Mobile Link が直接呼び出すアセンブリのみです。このアセンブリによって、その他の必要なアセンブリが呼び出されます。

たとえば、Mobile Link が MyAssembly を呼び出すと、MyAssembly が UtilityAssembly と NetworkingUtilsAssembly を呼び出します。この場合は、Mobile Link が MyAssembly だけを探すように設定します。

Mobile Link では、次の方法でアセンブリをロードできます。

-sl dnet ( -MLAutoLoadPath ) を使用 このオプションは、プライベートアセンブリに対してのみ有効です。このオプションは、アプリケーションのベースディレクトリへのパスを設定し、そのディレクトリ内のすべてのアセンブリをロードします。
-MLAutoLoadPath オプションを使用すると、イベントスクリプトの完全に修飾されたメソッド名を入力するときに、ドメインを指定できません。

-MLAutoLoadPath でパスとディレクトリを指定すると、次のアクションが実行されます。
- このパスがアプリケーションベースパスとして設定される
- 指定したディレクトリで .dll または .exe の付くすべてのファイルのすべてのクラスがロードされる
- 1 つのアプリケーションドメインが作成され、ドメインが指定されていないすべてのユーザクラスがそのドメインにロードされる
このオプションでは、グローバルアセンブリキャッシュ内のアセンブリを直接呼び出すことはできません。これらの共有アセンブリを呼び出すには、-MLDomConfigFile を使用します。
-sl dnet ( -MLDomConfigFile ) を使用 このオプションは、プライベートアセンブリと共有アセンブリの両方に使用できます。このオプションを使用するには、ドメインとアセンブリの設定を含む設定ファイルが必要です。このオプションは、共有アセンブリがある場合、アプリケーションベースパス内のすべてのアセンブリをロードする必要がない場合、またはその他の理由で設定ファイルを使用する必要がある場合に使用してください。
このオプションを使用すると、Mobile Link は指定されたドメイン設定ファイル内の設定を読み込みます。ドメイン設定ファイルには、1 つまたは複数の .NET ドメインの設定が入っています。このファイルに複数のドメインが記述されている場合は、1 番目に指定されているドメインがデフォルトドメインとして使用されます (デフォルトドメインは、指定されたドメインがスクリプトにない場合に使用されます)。

Mobile Link はアセンブリをロードするときに、まずプライベートアセンブリとしてロードし、次にグローバルアセンブリキャッシュからアセンブリをロードしようとします。プライベートアセンブリは、アプリケーションベースフォルダにあります。共有アセンブリはグローバルアセンブリキャッシュからロードされます。

-MLDomConfigFile オプションでは、ドメイン設定ファイルで指定されているアセンブリのみが、イベントスクリプトから直接呼び出せます。

サンプルのドメイン設定ファイル

mlDomConfig.xml というサンプルのドメイン設定ファイルが、Mobile Link とともにインストールされます。独自のファイルを最初から作成するか、要件に合わせてサンプルを編集できます。サンプルファイルは、SQL Anywhere の次のパスにあります。

MobiLink\setup\dnet\mlDomConfig.xml

サンプルのドメイン設定ファイル mlDomConfig.xml の内容は次のとおりです。

<?xml version="1.0" encoding="utf-8"?>
<config xmlns="iAnywhere.MobiLink.mlDomConfig" xsi:schemaLocation='iAnywhere.MobiLink.mlDomConfig mlDomConfig.xsd' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' >
    <domain>
        <name>SampleDomain1</name>
        <appBase>C:\scriptsDir</appBase>
        <configFile></configFile>
        <assembly name="Assembly1" />
        <assembly name="Assembly2" />
    </domain>

    <domain>
        <name>SampleDomain2</name>
        <appBase>\Dom2assembly</appBase>
        <configFile>\Dom2assembly\AssemblyRedirects.config</configFile>
        <assembly name="Assembly3" />
        <assembly name="Assembly4" />
    </domain>
</config>

次に、mlDomConfig.xml の内容について説明します。

name イベントスクリプトでドメインを指定するときに使用するドメイン名です。"DomainName:Namespace.Class.Method" というフォーマットのイベントスクリプトを使用するには、ドメイン設定ファイル内に DomainName ドメインが必要です。
ドメイン名は 1 つ以上指定してください。
appBase ドメインがアプリケーションベースディレクトリとして使用するディレクトリです。すべてのプライベートアセンブリは、このディレクトリに基づいて .NET CLR によってロードされます。appBase は必ず指定してください。
configFile ドメインに使用する .NET アプリケーション設定ファイルです。ここは空白でもかまいません。通常は、この部分を使用してアセンブリのバインドとロードのデフォルトの動作を変更します。アプリケーション設定ファイルの詳細については、.NET のマニュアルを参照してください。
assembly イベントスクリプト内の型の参照を解決するときに Mobile Link がロードして検索するアセンブリの名前です。アセンブリは 1 つ以上指定してください。アセンブリが複数のドメインで使用されている場合は、ドメインごとに 1 つのアセンブリを指定してください。プライベートアセンブリの場合は、ドメインのアプリケーションベースディレクトリになければなりません。

mlsrv16 オプションの -sl dnet の詳細については、-sl dnet mlsrv16 オプションを参照してください。

DocCommentXchange で意見交換できます