エクスポートサービス

トピックの内容

C1 ASP.NET Export Service を使用すると、複雑なエクスポートアプリケーションを作成しなくても、GridView を Excel、CSV、および PDF にエクスポートできます。このサービスはアプリケーションサーバー上に置かれます。

C1 ASP.NET Export Service を使用する利点は次のとおりです。

書式設定を維持したままグリッドをエクスポートできます。
エクスポートされたファイルの設定を必要に応じて変更できます。

インストール

Export Service は、インターネットインフォメーションサービス（IIS）上に配布される Web アプリケーションです。 C:\Program Files\ComponentOne\ASP.NET Web Forms フォルダにある C1ASPNETExportService インストーラを実行してください。次のファイルが IIS にインストールされます。

これらのファイルは、次の場所にも格納されています。

C:\ProgramData\ComponentOne\C1ASPNET\C1APNETExportService

システム要件

サービスホストのシステム要件は次のとおりです。

Microsoft Windows 7 以上。
ASP.NET 4.0 以上（.NET Framework 4.0）を含む IIS 7.0 以上。

Microsoft Windows 7 または Microsoft Windows Server 2008 R2 では .NetFramework 4.0 をアップデートできます。詳細については、「http://support.microsoft.com/kb/2468871」を参照してください。

GridView のエクスポート設定

グリッドをさまざまな形式でダウンロードするための設定は、次のとおりです。

Excel にエクスポート

ファイル形式：GridView は、xls または xlsx 形式の Excel シートにエクスポートできます。
作成者：データの書き込みに対して責任を負う人または組織の名前を指定します。
行の高さの自動調整：行の高さを内容に応じて自動的に調整するかどうかを選択します。
サーバー URL：エクスポートするグリッドがあるサーバーの URL を設定します。"<サーバーの URL> /exportapi/grid" を入力します。
ファイル名：エクスポートされるファイルに使用する名前を設定します。

CSV にエクスポート

サーバー URL：エクスポートするグリッドがあるサーバーの URL を設定します。 "<サーバーの URL>/exportapi/grid" を入力します。
ファイル名：エクスポートされるファイルに使用する名前を設定します。

PDF にエクスポート

グリッドヘッダーを繰り返す：グリッドのヘッダーを繰り返します。
幅の自動調整：自動調整を有効にします。
横：横長モードを有効にします。
マージン設定：
- 上：上マージンのサイズをポイント単位で設定します。
- 下：下マージンのサイズをポイント単位で設定します。
- 右：右マージンのサイズをポイント単位で設定します。
- 左：左マージンのサイズをポイント単位で設定します。
- 用紙の種類：用紙の種類（Custom、Letter、LetterSmall など）を設定します。
用紙サイズ：
- 幅：ページの幅をポイント単位で設定します。
- 高さ：ページの高さをポイント単位で設定します。
ファイルの内容：
- 画質：画質を Low（低）、Medium（中）、または High（高）に設定します。
- 圧縮：圧縮レベルを Default（デフォルト）、None（なし）、Best Speed（速度優先）、または Best Compression（圧縮率優先）に設定します。
- フォントタイプ：フォントタイプを True Type または Embedded（埋め込み）に設定します。
ドキュメント情報：
- 作成者：ドキュメントを作成した人または組織の名前を設定します。
- 作成元アプリケーション：元のドキュメントを作成したアプリケーションの名前を設定します。
- サブタイトル：ドキュメントのサブタイトルを設定します。
- タイトル：タイトルバーに表示されるドキュメントのタイトルを設定します。
- PDF 作成アプリケーション：PDF ドキュメントを作成したアプリケーションの名前を設定します。
- キーワード：PDF ドキュメントに関連付けられるキーワードを設定します。これらのキーワードは、ドキュメントの検索に使用できます。
ドキュメントのセキュリティ：
- 暗号化の種類：暗号化の種類を NotPermit（許可しない）、Standard40、Standard128、または Aes128 に設定します。
- 所有者パスワード：ドキュメントの権限を編集するために必要なパスワードを設定します。
- ユーザーパスワード：ドキュメントを開くために必要なパスワードを設定します。
- コンテンツのコピーを許可：コンテンツのコピーを許可または禁止します。
- 注釈の編集を許可：ユーザーが注釈を編集することを許可または禁止します。
- コンテンツの編集を許可：ユーザーがドキュメントの内容を編集することを許可または禁止します。
- 印刷を許可：ドキュメントの印刷を許可または禁止します。
構成設定：
- サーバー URL：サーバーの URL を設定します。"<サーバーの URL>/exportapi/grid" を入力します。
- ファイル名：エクスポートされる PDF に使用するファイル名を設定します。

用途

GridView の内容を Excel、CSVS、または PDF にエクスポートするには、exportGrid メソッドを呼び出します。 GridView を Excel にエクスポートするには、<head> タグと</head> タグの間に次のコードを追加します。

 <script src="http://code.jquery.com/jquery-1.9.1.min.js"
type="text/javascript"></script> 
 <asp:PlaceHolder runat="server">
            <script type="text/javascript">

                $(function () {
                    $("#Button1").click(exportExcel);
                });
   
                // Export 関数
                function exportExcel() {
                    var fileName = "ExportedGrid";
                    var type = "Xls";
                    var excelSetting = {
                        showGridLines: true,
                        autoRowHeight: true,
                        author: "ComponentOne"
                    };
                    var url = "http://demos.componentone.com/ASPNET/ExportService"_
                        + "/exportapi/grid";
                    $("#<%=C1GridView1.ClientID%>").c1gridview("exportGrid", fileName,_
                        type, excelSetting, url);
    }
            </script>
    </asp:PlaceHolder>

GridView を CSV ファイルにエクスポートするには、<head> タグと </head> タグの間に次のコードを追加します。

        <script src="http://code.jquery.com/jquery-1.9.1.min.js" type="text/javascript"></script>   
 <asp:PlaceHolder ID="PlaceHolder1" runat="server">
            <script type="text/javascript">

                $(function () {
                    $("#Button1").click(exportCsv);
                });
               
                // Export 関数
                function exportCsv() {
                    var fileName = "ExportedGrid";
                    var url = "http://demos.componentone.com/ASPNET/ExportService"_
                               + "/exportapi/grid";
                    $("#<%=C1GridView1.ClientID%>").c1gridview("exportGrid",_
                               fileName, "csv", url);
    }
            </script>
        </asp:PlaceHolder>

GridView を PDF にエクスポートするには、<head> タグと </head> タグの間に次のコードを追加します。

<script src="http://code.jquery.com/jquery-1.9.1.min.js" type="text/javascript"></script>
    <asp:PlaceHolder ID="PlaceHolder1" runat="server">
            <script type="text/javascript">

                $(function () {
                    $("#Button1").click(exportPdf);
                   
                });

                // PDF 設定
                function getPdfSetting() {
                        return {
                            repeatHeader: true,
                            landscape: true,
                            autoFitWidth: true,
                            pageSize: {
                                width: 300,
                                height: 400
                            },
                            paperKind: 'A4',
                            margins: {
                                top: 50,
                                right: 50,
                                bottom: 50,
                                left: 50
                            },
                            imageQuality:'Low',
                            compression: 'BestCompression',
                            fontType: 'TrueType',
                            author: 'Grapecity',
                            creator: 'Grapecity',
                            subject: 'エクスポート',
                            title: 'Export Document',
                            producer: 'Grapecity',
                            keywords: 'export, pdf',                       
                            encryption: 'NotPermit',
                            ownerPassword: '0000',
                            userPassword: '00000',
                            allowCopyContent: true,
                            allowEditAnnotations: true,
                            allowEditContent: true,
                            allowPrint: true,
                        }                                      
                }    

                // Export 関数               
                    function exportPdf() {
                    var fileName = 'ExportGrid';
                    var pdfSetting = getPdfSetting();
                    var url = "http://demos.componentone.com/ASPNET/ExportService" +_
                         "/exportapi/grid";
                    $("#<%=C1GridView1.ClientID%>").c1gridview("exportGrid", fileName,_
                        "pdf", pdfSetting, url);
                    }

            </script>
</asp:PlaceHolder>

生成される PDF のプロパティを次の図に示します。

ファイルが Internet Explorer でダウンロードされない場合は、Internet Explorer の保護モードをオフにしてファイルをエクスポートするか、 Internet Explorer を管理者として実行します。保護モードをオフにするには、次のようにします。

Internet Explorer の［設定］を開き、［インターネットオプション］を選択します。
［セキュリティ］タブで、［インターネット］を選択し、 ［保護モードを有効にする］のチェックを外します。