SSpread.IsExcel2007Fileメソッド

説明

ファイルがExcel2007形式ブックかどうか、また保護されているかどうかを調べます

第2引数によりExcelファイルの判別方式を従来方式と新方式に切り替えることが可能です。

従来方式で正常に判別できないExcelファイルにおいて、新方式で正しく判別できる可能性があります。

より追加されました

より仕様が拡張されました

呼出形式

IsExcel2007File(URL or Reader[, newMode])

戻り値

以下の値が返ります

値	説明
0	Excel2007形式ファイルではない
1	Excel2007形式ファイル
2	パスワードで保護されたExcel2007形式ファイル

※パスワード保護されたExcel2007形式のファイルを、新しいファイル判別方式(引数:newModeに$TRUEを指定)で判定した場合、戻り値は固定で0が返ります。

引数

URL or Reader

読み込むExcel2007形式ファイルのURL、またはReaderオブジェクト

URLを指定した場合は、ファイルはローカルコンピュータにキャッシュされ、次回以降の読み込みが高速化されます。

HttpResponseオブジェクトを指定すれば、常にサーバから最新のファイルを取得できます。

newMode

新しいファイル判別方式を使用する場合は$TRUEを、使用しない場合は$FALSEを指定します。

省略時は$FALSE指定時と同等の動作となります。

※新しいファイル判別方式では、パスワード保護されたExcel2007形式ファイルの判定は行えません。

パスワード保護されていないExcel2007形式のファイルのみ判定が可能です。

より仕様が拡張されました

例外

EXT-24

有効なReaderオブジェクトが指定されていません

使用例

var session = findHttpSession("http://example.com");
var res = session.Get("excel2007file.xlsx");
if (IsExcel2007File(res) > 0) {
    MessageBox("これはExcel2007形式ファイルです");
}