ActiveReports for .NET 18.0J
ActiveReportsの構成ファイル
ActiveReportsユーザーガイド > ActiveReports for .NETへようこそ > ActiveReportsの構成ファイル

ActiveReportsの構成ファイル（ActiveReports.config）は、デフォルトで「C:\Program Files (x86)\ActiveReportsNETxx」にインストールされます。

構成ファイルでは、以下の機能を設定できます。

  1. レポート新規作成時にデータソースウィザードの起動を制御する
  2. ［印刷］ダイアログボックスの設定
  3. ChartClassicを有効にする
  4. ページ／RDLレポートで新しいチャートを無効にする
  5. 改行アルゴリズムを指定する
  6. カスタムレポートアイテム
  7. カスタムフォントを指定する
  8. Mapコントロールとタイルプロバイダー
  9. カスタムタイルプロバイダー
  10. カスタムデータプロバイダー
  11. レポート検証を無効にする

１．レポート新規作成時にデータソースウィザードの起動を制御する

LaunchDataSourceWizardキーの値を「false」に設定して、ウィザードのデフォルトの動作を無効にできます。これにより、新しいレポートを作成する時に［レポートデータソース］ダイアログが開きません。

ActiveReports.configファイル内に貼り付けます。
コードのコピー 
<Configuration>
  <appSettings>
    <add key="LaunchDataSourceWizard" value="false"/>
  </appSettings>
</Configuration>

２．［印刷］ダイアログボックスの設定

以下のように、PrintDialogStyleキーを設定して、デザイナのデフォルトの印刷ダイアログを変更できます。

ActiveReports.configファイル内に貼り付けます。
コードのコピー 
<Configuration>
  <appSettings>             
                     
          <!-- OSネイティブの印刷ダイアログの場合 -->
                <add key="PrintDialogStyle" value="Standard"/>
               
          <!-- Windows XPスタイルで表示されるOSネイティブの印刷ダイアログの場合
                <add key="PrintDialogStyle" value="XpStyle"/>

               詳細設定を備えた［印刷］ダイアログボックスの場合 
                <add key="PrintDialogStyle" value="Advanced"/> --> 
  </appSettings>
</Configuration>

３．ChartClassicを有効にする

EnableChartClassicキーを「true」に設定して、デザイナでChartClassicを有効にできます。

ActiveReports.configファイル内に貼り付けます。
コードのコピー 
<Configuration>
  <appSettings>
    <add key="EnableChartClassic" value="true"/>
  </appSettings>
</Configuration>

詳細については、「ChartClassic」を参照してください。

４．ページ／RDLレポートで新しいチャートを無効にする

EnableChartキーを「false」に設定して、デザイナでChartClassicを無効にできます。

ActiveReports.configファイル内に貼り付けます。
コードのコピー 
<Configuration>
  <appSettings>
    <add key="EnableChart" value="false"/>
  </appSettings>
</Configuration>

詳細については、「Chart」を参照してください。

５．改行アルゴリズムを指定する

LineBreakingAlgorithmキーを「Legacy」に設定して、数値を含む文字列を折り返して表示します。デフォルトでは、「Unicode」に設定されます。

ActiveReports.configファイル内に貼り付けます。
コードのコピー 
<Configuration>
    <appSettings>
        <add key="LineBreakingAlgorithm" value="Legacy"/>
    </appSettings>
</Configuration>

６．カスタムレポートアイテム

ページレポートとRDLレポートで使用できる既存のコントロールの機能を拡張できます。設定ファイルは次のようになります。

ActiveReports.configファイル内に貼り付けます。
コードのコピー 
<?xml version="1.0" encoding="utf-8" ?>
<Configuration>
    <Extensions>
        <ReportItems>
            <ReportItem Name="RadarChart" Type="GrapeCity.ActiveReports.Samples.Radar.RadarChart, RadarChart" />
        </ReportItems>
        <ReportItemDesigner>
            <ReportItem Name="RadarChart" Type="GrapeCity.ActiveReports.Samples.Radar.RadarDesigner, RadarDesigner" BitmapResource="GrapeCity.ActiveReports.Samples.Radar.RadarIcon.png" />
        </ReportItemDesigner>
    </Extensions>
</Configuration>

７．カスタムフォントを指定する

ActiveReports.configファイルでは、ページ、RDL、およびセクションレポート（クロスプラットフォーム互換モード）で使用するカスタムフォントを指定できます。

デフォルトフォントの設定よりも、カスタムフォントの設定が優先されます。
ActiveReports.configファイル内に貼り付けます。
コードのコピー 
<Configuration>
     <Extensions>
           <FontFactory>
                <AddFolder Path="%WINDIR%/Fonts" Recurse="true" />
                <AddFolder Path="%USERPROFILE%/AppData/Local/Microsoft/Windows/Fonts" Recurse="true" />
                <Substitute Font="Arabic Transparent" To="Arial" />
                <Substitute Font="Coutier" To="Coutier New" />
                <Substitute Font="Helv" To="Arial" />
                <Substitute Font="Helvetica" To="Arial" />
                <Substitute Font="MS Sans Serif" To="Microsoft Sans Serif" />
                <Substitute Font="MS Serif" To="Times New Roman" />
                <Substitute Font="Times" To="Times New Roman" />
                <Substitute Font="Tms Rmn" To="Times New Roman" />
                <SetFallbackFont Font="Microsoft Sans Serif" />
                <SetFallbackFont Font="MS UI Gothic" />
                <SetFallbackFont Font="Arial" />
                <AddFontLink Font="Lucida Sans Unicode" List="MS UI Gothic,PMingLiU,SimSun,Gulim,Yu Gothic UI,Microsoft JhengHei UI,Microsoft YaHei UI,Malgun Gothic" />
                <AddFontLink Font="Microsoft Sans Serif" List="MS UI Gothic,Yu Gothic UI,PMingLiU,SimSun,Gulim,Microsoft JhengHei UI,Microsoft YaHei UI,Malgun Gothic" />
                <AddFontLink Font="Tahoma" List="MS UI Gothic,PMingLiU,SimSun,Gulim,Yu Gothic UI,Microsoft JhengHei UI,Microsoft YaHei UI,Malgun Gothic" />
                <AddFontLink Font="Segoe UI" List="Tahoma,Meiryo UI,MS UI Gothic,Microsoft JhengHei UI,Microsoft YaHei UI,Malgun Gothic,PMingLiU,SimSun,Gulim,Yu Gothic UI" />
                <AddFontLink Font="Ebrima" List="Segoe UI,Meiryo UI,Microsoft JhengHei UI,Microsoft YaHei UI,Malgun Gothic,Yu Gothic UI" />
                <AddFontLink Font="Gadugi" List="Segoe UI,Meiryo UI,Microsoft JhengHei UI,Microsoft YaHei UI,Malgun Gothic,Yu Gothic UI" />
                <AddFontLink Font="Khmer UI" List="Segoe UI,Meiryo UI,Microsoft JhengHei UI,Microsoft YaHei UI,Malgun Gothic,Yu Gothic UI" />
                <AddFontLink Font="Lao UI" List="Segoe UI,Meiryo UI,Microsoft JhengHei UI,Microsoft YaHei UI,Malgun Gothic,Yu Gothic UI" />
                <AddFontLink Font="Leelawadee" List="Segoe UI,Meiryo UI,Microsoft JhengHei UI,Microsoft YaHei UI,Malgun Gothic,Yu Gothic UI" />
                <AddFontLink Font="Leelawadee UI" List="Segoe UI,Meiryo UI,Microsoft JhengHei UI,Microsoft YaHei UI,Malgun Gothic,Yu Gothic UI" />
                <AddFontLink Font="Nirmala UI" List="Segoe UI,Meiryo UI,Microsoft JhengHei UI,Microsoft YaHei UI,Malgun Gothic,Yu Gothic UI" />
                <AddFontLink Font="MingLiU" List="Microsoft Sans Serif,SimSun,MS Mincho,BatangChe,Microsoft JhengHei UI,Microsoft YaHei UI,Yu Gothic UI,Malgun Gothic" />
                <AddFontLink Font="PMingLiU" List="Microsoft Sans Serif,SimSun,MS PMincho,Batang,Microsoft JhengHei UI,Microsoft YaHei UI,Yu Gothic UI,Malgun Gothic" />
                <AddFontLink Font="Microsoft JhengHei" List="Segoe UI,MingLiU,Microsoft YaHei,Meiryo,Malgun Gothic,Yu Gothic UI" />
                <AddFontLink Font="Microsoft JhengHei UI" List="Segoe UI,MingLiU,Microsoft YaHei UI,Meiryo UI,Malgun Gothic,Yu Gothic UI" />
                <AddFontLink Font="SimSun" List="Microsoft Sans Serif,PMingLiU,MS PMincho,Batang,Microsoft YaHei UI,Microsoft JhengHei UI,Yu Gothic UI,Malgun Gothic" />
                <AddFontLink Font="NSimSun" List="PMingLiU,MS Mincho,BatangChe,Microsoft YaHei UI,Microsoft JhengHei UI,Yu Gothic UI,Malgun Gothic" />
                <AddFontLink Font="Microsoft YaHei" List="Segoe UI,Segoe UI,SimSun,Microsoft JhengHei,Meiryo,Malgun Gothic,Yu Gothic UI" />
                <AddFontLink Font="Microsoft YaHei UI" List="Segoe UI,SimSun,Microsoft Jhenghei UI,Meiryo UI,Malgun Gothic,Yu Gothic UI" />
                <AddFontLink Font="Yu Gothic UI" List="Segoe UI,Microsoft JhengHei,Microsoft YaHei,Malgun Gothic" />
                <AddFontLink Font="Meiryo" List="Segoe UI,Yu Gothic UI,MS UI Gothic,Microsoft Jhenghei,Microsoft YaHei,Malgun Gothic" />
                <AddFontLink Font="Meiryo UI" List="Segoe UI,Yu Gothic UI,MS UI Gothic,Microsoft Jhenghei UI,Microsoft YaHei UI,Malgun Gothic" />
                <AddFontLink Font="MS Gothic" List="MingLiU,SimSun,GulimChe,Yu Gothic UI,Microsoft JhengHei UI,Microsoft YaHei UI,Malgun Gothic" />
                <AddFontLink Font="MS PGothic" List="PMingLiU,SimSun,Gulim,Yu Gothic UI,Microsoft JhengHei UI,Microsoft YaHei UI,Malgun Gothic" />
                <AddFontLink Font="MS UI Gothic" List="Microsoft Sans Serif,PMingLiU,SimSun,Gulim,Yu Gothic UI,Microsoft JhengHei UI,Microsoft YaHei UI,Malgun Gothic" />
                <AddFontLink Font="MS Mincho" List="MingLiU,SimSun,Batang,Yu Gothic UI,Microsoft JhengHei UI,Microsoft YaHei UI,Malgun Gothic" />
                <AddFontLink Font="MS PMincho" List="PMingLiU,SimSun,Batang,Yu Gothic UI,Microsoft JhengHei UI,Microsoft YaHei UI,Malgun Gothic" />
                <AddFontLink Font="Batang" List="MS PMincho,PMingLiU,SimSun,Malgun Gothic,Yu Gothic UI,Microsoft JhengHei UI,Microsoft YaHei UI" />
                <AddFontLink Font="BatangChe" List="MS Mincho,MingLiU,SimSun,Malgun Gothic,Yu Gothic UI,Microsoft JhengHei UI,Microsoft YaHei UI" />
                <AddFontLink Font="Dotum" List="MS UI Gothic,PMingLiU,SimSun,Malgun Gothic,Yu Gothic UI,Microsoft JhengHei UI,Microsoft YaHei UI" />
                <AddFontLink Font="DotumChe" List="MS Gothic,MingLiU,SimSun,Malgun Gothic,Yu Gothic UI,Microsoft JhengHei UI,Microsoft YaHei UI" />
                <AddFontLink Font="Gulim" List="Microsoft Sans Serif,MS UI Gothic,PMingLiU,SimSun,Malgun Gothic,Yu Gothic UI,Microsoft JhengHei UI,Microsoft YaHei UI" />
                <AddFontLink Font="GulimChe" List="MS Gothic,MingLiU,SimSun,Malgun Gothic,Yu Gothic UI,Microsoft JhengHei UI,Microsoft YaHei UI" />
                <AddFontLink Font="Gungsuh" List="MS PMincho,PMingLiU,SimSun,Malgun Gothic,Yu Gothic UI,Microsoft JhengHei UI,Microsoft YaHei UI" />
                <AddFontLink Font="GungsuhChe" List="MS Mincho,MingLiU,SimSun,Malgun Gothic,Yu Gothic UI,Microsoft JhengHei UI,Microsoft YaHei UI" />
                <AddFontLink Font="Malgun Gothic" List="Segoe UI,Gulim,Meiryo UI,Microsoft Jhenghei UI,Microsoft YaHei UI,Yu Gothic UI" />
                <DefaultEudcFont File="EUDC.tte" />
                <AddEudcFont Font="MS UI Gothic" File="myEUDC1.tte" />
                <AddEudcFont Font="Meiryo" File="myEUDC2.tte" />
              </FontFactory>
     </Extensions>
</Configuration>

詳細については、「カスタムフォント設定」を参照してください。

カスタムフォント構成設定

要素 説明
AddFolder 指定したフォルダ内にあるすべてのTrueTypeフォントを使用します。ファイルシステムの絶対パスを指定するには、Path属性を指定します。ファクトリがフォルダを再帰的に読み取るには、RecurseをTrueに設定します。
Substitute 代替フォントを指定します。
SetFallbackFont

フォントがインストールされていない場合、または代替フォントが指定されていない場合に使用するフォントを指定します。
AddFontLink  フォントリンクを指定します。Fontで指定されたグリフが見つからない場合、Listで指定されているフォントを使用します。Listはカンマ区切りで複数のフォントを指定できます。
DefaultEudcFont

すべてのフォントの既定の一意のEUDCフォントを指定します。これは、AddFolderにある最初のフォントに対する絶対パスまたは相対パスです。レジストリのSystemDefaultEudcFontエントリのようなノードです。詳細については、「外字」を参照してください。
AddEudcFont EUDCファイルをフォント名に関連付けます。詳細については、「外字」を参照してください。

８．Mapコントロールとタイルプロバイダー

Mapコントロールを使用すると、組み込みのタイルプロバイダーと拡張機能をカスタムレポートアイテムで構成できます。一般に、外部プロバイダーはリソースに対するサポートが制限されていて、無制限にアクセスするには、外部キーが必要です。ActiveReportsでは、次のキーを構成できます。

 以下のサンプルコードは、上記のキーを構成する例です。 

ActiveReports.configファイル
コードのコピー 
<?xml version="1.0" encoding="utf-8" ?>
<Configuration>
    <Extensions>
        <MapTileProviders>
            <MapTileProvider Name="MapQuest" DisplayName="MapQuest Tiles">
                <Settings>
                    <add key="ApiKey" value="Fmjtd%7Cluur21ua2l%2C2x%3Do5-90t5h6" />
                    <add key="Timeout" value="5000" />
                </Settings>
            </MapTileProvider>
            <MapTileProvider Name="Google" DisplayName="Google Tiles">
                <Settings>
                    <add key="ApiKey" value="AIzaSyBdJ88HN7LTGkHHK5whfaVv8a5ozlx2E_k" />
                    <add key="Timeout" value="5000" />
                </Settings>
            </MapTileProvider>
            <MapTileProvider Name="Bing" DisplayName="Bing Tiles" >
                <Settings>
                    <add key="ApiKey" value="Al3SxHf0LOva-5GI5fOajO0LCuKjYKLarjWQFcdGiKfaJNRrE6SBbH9o3-HJDOX7" />
                    <add key="Timeout" value="5000" />
                </Settings>
            </MapTileProvider>
        </MapTileProviders>
    </Extensions>
</Configuration>

９．カスタムタイルプロバイダー

次のように、独自のタイルプロバイダーを実装して、ActiveReportsに登録できます。

ActiveReports.configファイル
コードのコピー 
<?xml version="1.0" encoding="utf-8" ?>
<Configuration>
    <Extensions>
        <MapTileProviders>
            <MapTileProvider Name="MapQuest-Sample" DisplayName="MapQuest-Sample" Type="GrapeCity.ActiveReports.Samples.CustomTileProviders.MapQuestTileProvider, CustomTileProviders, Version=1.0.0.0">
                <Settings>
                    <add key="ApiKey" value="Fmjtd%7Cluur21ua2l%2C2x%3Do5-90t5h6" />
                    <add key="Timeout" value="3000" />
                </Settings>
            </MapTileProvider>
        </MapTileProviders>
    </Extensions>
</Configuration>

詳細については、「カスタムタイルプロバイダ サンプル」を参照してください。

１０．カスタムデータプロバイダー

次のように、構成ファイルを編集して、カスタムデータプロバイダーを構成できます。

ActiveReports.configファイル
コードのコピー 
<?xml version="1.0" encoding="utf-8" ?>
<Configuration>
    <Extensions>
        <Data>
            <Extension Name="SQLITE" Type="System.Data.SQLite.SQLiteFactory, System.Data.SQLite"
                       DisplayName="Sqlite Provider" />
        </Data>
    </Extensions>
</Configuration>

カスタムUIが必要な場合は、次のようにCommandTextEditorTypeキーを使用します。

ActiveReports.configファイル
コードのコピー 
<?xml version="1.0" encoding="utf-8" ?>
<Configuration>
    <Extensions>
        <Data>
            <Extension Name="CustomCSV"
             DisplayName="CSV Data Provider"
             Type="GrapeCity.ActiveReports.Samples.CustomDataProvider.CSVDataProvider.CsvDataProviderFactory,CustomDataProvider, version=0.0.0.0, Culture=neutral"
             CommandTextEditorType="GrapeCity.ActiveReports.Samples.CustomDataProviderUI.QueryEditor,CustomDataProviderUI, Version=1.0.0.0, Culture=neutral"
            />
        </Data>
    </Extensions>
</Configuration>

詳細については、「カスタムデータプロバイダ サンプル」を参照してください。

１１．レポート検証を無効にする

WinViewerおよびエンドユーザーデザイナでは、レポートのクラッシュを防ぐために実行されるレポート検証を無効にすることができます。デフォルトでは、レポート検証が有効になっています。

ActiveReports.configファイル
コードのコピー 
<add key="SkipReportValidation" value="true"/>

WebViewerでレポート検証を無効にするには、UseReportingメソッドの設定で構成ファイルを指定する必要があります。

ActiveReports.configファイル
コードのコピー 
app.UseReporting(settings =>
{
//...
settings.UseConfig("C:\Program Files (x86)\ActiveReportsNET18\ActiveReports.config");
});
関連トピック
フォント設定機能

© MESCIUS inc. All rights reserved.