Excelファイルへの保存

FpSpreadクラスのSaveExcel メソッドを使用して、データをExcelファイルに保存することができます。このメソッドの引数には、保存するファイルのパスと名前、またはStreamオブジェクトを指定できます。メソッドのオーバーロードにより、他にも指定できる引数があります。

SaveExcelメソッドでは、パラメータとしてExcelSaveFlags列挙体を使用できます。この列挙体は、Excelでデータを保存するために以下の形式を提供します。

Excelワークブック形式（.xlsxファイル）
Excel 97-2003 BIFF8形式（.xlsファイル）

Excelワークブック形式でデータを保存するには、UseOOXMLFormatオプションを使用します。スプレッドシートデータだけではなく、スプレッドシートに加えたすべての設定も一緒にExcelファイルに保存するには、さらにExchangeableオプションを選択する必要があります。Exchangeableオプションを使用すると、ExcelファイルをSpreadにエクスポートおよびインポート（ExcelOpenFlags のExchangeableオプションを使用して）しても、データ全体を保持できます。 Exchangeableオプションを使用して保存したファイルを再度読み込むと、SPREADに保存前の状態を復元することができます。そのため、再度読み込む前にExcelファイルを上書き保存すると期待動作にならない場合があります。

デフォルトでは、Excelへの保存時、Spreadのデータモデルに保存された内容はすべて、BIFF8形式でファイルまたはストリームに書き込まれます。

Excelへのイメージ型セルのエクスポート

イメージ型セルを含むスプレッドシートをExcelファイルに保存する場合、次のような動作になります。

Exchangeableオプションを指定すると、イメージ型セルがXLSXファイルに保存されます。
- エクスポートされたファイルをExcelで開くと、空のセルが表示されます。
- Exchangeableオプションを使用せずにエクスポートされたファイルをSpreadで開くと、空のセルが表示されます
- Exchangeableオプションを使用してエクスポートされたファイルをSpreadで開くと、イメージ型セルが表示されます。
Exchangeableオプションを指定しないと、イメージ型セルがXLSXファイルに保存されないで、シェイプとしてエクスポートされます。
- Exchangeableオプションを使用するかどうかに関わらず、エクスポートされたファイルをExcelまたはSpreadで開くと、空のセルとシェイプが表示されます。

サンプルコード

次のサンプルコードは、引数としてUseOOXMLFormatおよびExchangeableオプションがあるExcelSaveFlags列挙体を持つSaveExcelメソッドを使用して、Spreadデータと、そのすべての設定をExcelファイルに保存します。

C#	コードのコピー
// SpreadデータをExcelファイル（.xlsx）に保存します。 fpSpread1.SaveExcel("C:\\excelfile.xlsx", FarPoint.Excel.ExcelSaveFlags.UseOOXMLFormat \| FarPoint.Excel.ExcelSaveFlags.Exchangeable);

コードのコピー

// SpreadデータをExcelファイル（.xlsx）に保存します。
fpSpread1.SaveExcel("C:\\excelfile.xlsx", FarPoint.Excel.ExcelSaveFlags.UseOOXMLFormat | FarPoint.Excel.ExcelSaveFlags.Exchangeable);

VB	コードのコピー
' SpreadデータをExcelファイル（.xlsx）に保存します。 fpSpread1.SaveExcel("C:\\excelfile.xlsx", FarPoint.Excel.ExcelSaveFlags.UseOOXMLFormat Or FarPoint.Excel.ExcelSaveFlags.Exchangeable)

コードのコピー

' SpreadデータをExcelファイル（.xlsx）に保存します。
fpSpread1.SaveExcel("C:\\excelfile.xlsx", FarPoint.Excel.ExcelSaveFlags.UseOOXMLFormat Or FarPoint.Excel.ExcelSaveFlags.Exchangeable)

メモ: Excelでは、セルに数値または日付を入力し、列幅がデータを表示するのに十分でない場合、セルは「###」と表示されます。コントロールのデータをExcelファイルに出力する場合、Excelでデータが適切に表示されるように、十分な列幅を設定してください。

SPREAD デザイナの使用

［ファイル］メニューから［保存］を選択します。［名前を付けて保存］ダイアログが表示されます。
［ファイルの種類］ボックスでExcel形式（*.xls）を指定します。
ファイル保存先のパスとファイル名を指定します。
［Excel保存フラグを選択］ドロップダウンリストから［Exchangeable］および［UseOOXMLFormat］オプションを選択し、［保存］をクリックします。ファイルが正常に保存されると、ファイルの保存が完了したことを伝えるメッセージが表示されます。
［OK］をクリックして、SPREADデザイナを終了します。

サンプルコード

次のサンプルコードは、SpreadコンポーネントのデータをExcel形式ファイルに保存し、行および列ヘッダが出力されるように指定します。

C#	コードのコピー
// データとヘッダをExcel形式ファイルに保存します。 fpSpread1.SaveExcel("C:\\excelfile.xls", FarPoint.Win.Spread.Model.IncludeHeaders.BothCustomOnly);

VB	コードのコピー
' データとヘッダをExcel形式ファイルに保存します。 fpSpread1.SaveExcel("C:\excelfile.xls", FarPoint.Win.Spread.Model.IncludeHeaders.BothCustomOnly)

ドキュメントキャッシュ

ExcelOpenFlags列挙体またはExcelSaveFlags列挙体のDocumentCachingオプション（ドキュメントキャッシュ）を使用すると、ドキュメントを開いて編集、保存するときに高度なドキュメントコンテンツや書式が失われません。内容が失われないのは、開いているファイル形式が保存するファイル形式とよく似ている場合のみです。高度なドキュメントコンテンツでxls(x)ファイルの他のファイルが使用されている場合は、それらの追加ファイルをxls(x)ファイルと同じフォルダーに置いておく必要があります。高度なコンテンツには、マクロ、ActiveXコントロール、データ接続などがあります。

Excelファイルにデータを保存する方法については、「Excel 形式ファイルのインポート／エクスポート」を参照してください。

参照