住所情報を検索するためには、住所の辞書ファイルが必要です。住所検索ライブラリは、辞書ファイルとして下記3つのファイルを使用します。

上記3つのファイルの他に、辞書ファイルの更新情報を保存する以下のファイルが必要です。このファイルには更新日時やそれぞれの辞書ファイルの更新年月が記載されています。

これらの辞書ファイルは[%CommonApplicationData%]\GrapeCity\JPAddress フォルダにインストールされます。この既定のフォルダに配置した辞書ファイルは、コンピュータ上の複数ユーザーや複数アプリケーションが共有して利用できます。JPAddress は既定でこのフォルダを参照します。

デフォルトの[%CommonApplicationData%]フォルダは、以下のとおりです。（C ドライブがシステムドライブの場合）

• C:\ProgramData\GrapeCity\JPAddress

また、同じファイルは、[%インストール フォルダ%]\Data フォルダに zip 形式の圧縮ファイル(JPAddressDB.zip)としてインストールされます。このファイルは辞書ファイルを配布する際に利用します。

Windows フォームアプリケーションで上記の既定の参照先から任意のフォルダに参照先を変更したい場合には、アプリケーションの構成ファイルに辞書ファイルへの参照を追加します。App.config ファイルに次のような構成セクションを追加して、辞書ファイルの配置場所を指定します。

<configuration>
<appSettings>
  <add key="JPAddressDataFileDirectory" value="./Data" />
</appSettings>
</configuration>

Windows フォームアプリケーションでは、EXE と同じフォルダに辞書ファイルを配置することも可能です。アプリケーションの EXE と同じフォルダに辞書ファイルが配置されると既定のフォルダに配置されたファイルよりも優先して参照され、構成ファイルに設定は不要です。

Windows の UAC（ユーザーアカウント制御）が有効な環境では Program Files フォルダや[%CommonApplicationData%]フォルダへの書き込みが制限されるため、書き込みが制限されているフォルダに辞書ファイルが配置されている場合には辞書ファイルの更新が正しく行われません。この場合はアプリケーションを管理者権限で起動するか、もしくは書き込みが制限されていないフォルダに辞書ファイルを配置します。

<configuration>
  <appSettings>
    <add key="JPAddressDataFileDirectory" value="~/Bin/Data" />
  </appSettings>
</configuration>

上記の場所のいずれのフォルダにも辞書ファイルが存在しない場合は、例外が発生します。