ストレージからのデータを使用したワークブック形式の変換

このセクションでは、クライアントアプリケーションを通してWeb APIサービスを呼び出し、ストレージ（リモートストレージまたは同じサーバー上のストレージ）内で使用可能なExcelファイルを別のファイル形式に変換する方法を具体的に示します。

次の例では、Web APIサービスをHTMLおよびWinFormsクライアントアプリケーションから呼び出します。これらのクライアントはサービスにGET要求を送り、サービスは応答ストリームを返します。これにより、この応答ストリームは目的のExcelファイル形式で保存されます。

次の例では、サービスURLは、WorkBookFileName パラメータにExcelワークブック（ストレージ内に存在）を取り、Typeパラメータに目的のファイル形式であるjsonを取ります。指定されたExcelワークブック、results.xlsxは、ホストされるサービスのルートフォルダに存在します。

手順1：サービスを呼び出す

Web APIサービスを呼び出すには、次の手順を実行します。

C#
HTML

「REST APIサービスに対するクライアントの設定」の説明に従ってWinFormsアプリケーションを作成します。1つのC1Label、1つのC1TextBox、および1つのC1Buttonコントロールを追加します。フォームが次のように表示されます。

以下に示すように、お使いのWinFormsアプリケーションのフォームクラスにメソッド（たとえば、ConvertExcel()）を定義して、サービスアプリケーションを呼び出します。

C#	コードのコピー
public void ConvertExcel() { var apiURL = string.IsNullOrEmpty(C1TextBox1.Text) ? "http://demos.componentone.com/ASPNET/C1WebAPIService/api/excel?FileName=excel&type=json&workbookfilename=root%2Grouping.xlsx" : C1TextBox1.Text; WebRequest request = WebRequest.Create(apiURL); WebResponse response = request.GetResponse(); var fileStream = File.Create("D:\\ExcelConvert.json"); response.GetResponseStream().CopyTo(fileStream); }

コードのコピー

public void ConvertExcel()
        {
        var apiURL = string.IsNullOrEmpty(C1TextBox1.Text) ? "http://demos.componentone.com/ASPNET/C1WebAPIService/api/excel?FileName=excel&type=json&workbookfilename=root%2Grouping.xlsx"
                            : C1TextBox1.Text;
        WebRequest request = WebRequest.Create(apiURL);
        WebResponse response = request.GetResponse();
        var fileStream = File.Create("D:\\ExcelConvert.json");
        response.GetResponseStream().CopyTo(fileStream);
        }

［Excel形式の変換］ボタンのボタンクリックイベントで、ConvertExcel()メソッドを呼び出します。

「REST APIサービスに対するクライアントの設定」の説明に従ってHTMLアプリケーションを作成します。

HTMLページの<body>タグ内の<form>タグに、以下のマークアップを追加します。

HTML	コードのコピー
<form action="http://demos.componentone.com/ASPNET/C1WebAPIService/api/excel" method="GET"> <label for="fileName">File Name:</label> <input type="text" id="fileName" name="fileName" value="ExcelConvert" /> <br /> <label for="fileFormat">File Format:</label> <input type="text" id="fileFormat" name="type" value="json" /> <br /> <label for="WorkBookFileName">WorkBook File Name:</label> <input type="text" id="WorkBookFileName" name="WorkBookFileName" value="root/Grouping.xlsx" /> <input type="submit" value="Convert Excel Format"/> </form>

HTML

コードのコピー

<form action="http://demos.componentone.com/ASPNET/C1WebAPIService/api/excel" method="GET">
        <label for="fileName">File Name:</label>
        <input type="text" id="fileName" name="fileName" value="ExcelConvert" />
        <br />
        <label for="fileFormat">File Format:</label>
        <input type="text" id="fileFormat" name="type" value="json" />
        <br />
        <label for="WorkBookFileName">WorkBook File Name:</label>
        <input type="text" id="WorkBookFileName" name="WorkBookFileName" value="root/Grouping.xlsx" />
        <input type="submit" value="Convert Excel Format"/>
</form>

GET要求に関して、<form>タグのmethod属性にGET、およびそのaction属性にサービス要求URLを設定したことに注意してください。また、HTMLページにコントロールを作成します。このコントロールは、各種パラメータを指定して、ストレージ内に存在するExcelワークブックから目的の形式でExcelを生成します。

先頭に戻る

手順2：クライアントプロジェクトを実行する

WinFormsアプリケーション

［ビルド］→［ソリューションのビルド］をクリックして、プロジェクトをビルドします。
［F5］を押してプロジェクトを実行します。
Request URLフィールドに対応するテキストボックスに、適切なパラメータを含むクエリー文字列と共に、サービスURLを指定します。
［Excel形式の変換］ボタンをクリックします。生成されたExcelデータストリームは、ConvertExcel()メソッドで指定された場所にダウンロードされます。

HTMLアプリケーション

HTMLファイルを保存し、それをブラウザで開きます。
目的のExcelファイル形式に該当するパラメータを設定して、［Excel形式の変換］ボタンをクリックします。

以下に示す、ワークブック形式を変換するREST APIサービスのデモサンプルをご覧ください。

Excel形式の変換のライブデモ

先頭に戻る