DEXTUpload.NET Professional
menu toggleリファレンス > DEXTUpload.NET > FileSignatureAnalyzer

DEXTUpload.NET
Class FileSignatureAnalyzer

サポートされる最小バージョン
5.2.0.0
最小サポート環境
.NET Framework 4.0
説明

ファイルシグネチャ検査を手動でしようとするときに使用するクラスです。

ファイルシグネチャ検査は「Web.config」ファイルの<dextupload.net><settings methodFileSignatureChecking="検査方法" .../>要素の設定値に基づいて異なる動作をする。 ファイルシグネチャ検査は「DEXTUpload.NET.FileUploadMonitorModule」モジュールオブジェクトで実行されるため、ファイルのアップロードをするすべての要求に対して同じように処理がされる。 万一、ページ(aspx)、ジェネリックハンドラ(ashx)またはMVCのコントローラでファイルのシグネチャ検査を直接実行したい場合は「FileSignatureAnalyzer」クラスを使用することができる。

using (var dext = new FileUpload())
{
    //シグネチャ検査ツールを生成する。
    var fsa = new FileSignatureAnalyzer();

    var element = dext.GetSingleFileElement();

    if (!element.IsEmpty)
    {
        //保存する前に、一時ファイルレベルでのチェックを行うことができる。
        var fsr = fsa.Check(element.FileExtension, element.TempFilePath);
        switch (fsr)
        {
            case FileSignatureResult.Absence:
                //この拡張子のシグネチャ情報が存在しない場合である。
                ...
                break;
            case FileSignatureResult.Different:
                //ファイルがシグネチャ情報と一致しない場合である。
                ...
                break;
            case FileSignatureResult.Same:
                //ファイルがシグネチャ情報と一致する場合である。
                break;
        }
    }
}
形式
public class FileSignatureAnalyzer
コンストラクタ

FileSignatureAnalyzer

  • 「FileSignatureAnalyzer」クラスのオブジェクトを生成する際に、初期化処理を実行する。

    パラメータなしのコンストラクターを使用してオブジェクトを作成すると、シグネチャ情報は、コンポーネントアセンブリの内部に含まれているリソースを使用する。もし他のリソースファイルを使用する必要があれば、コンストラクタに、対象ファイルのパスを設定すればよい。

  • 形式

    public FileSignatureAnalyzer()
    public FileSignatureAnalyzer(strign signatureDataFilePath)
    
  • パラメータ

    名前 形式 説明
    signatureDataFilePath System.String シグネチャデータファイルのパス(ローカルオペレーティングシステム)である。
属性

VersionString

  • シグネチャデータのバージョンを持って来る。

    シグネチャデータファイルは、内容が変更されるたびにバージョンが更新されるが、「VersionString」属性を持って、そのバージョンを確認することができる。

  • 形式

    public string VersionString { get; }
メソッド

Has

  • 指定された拡張子名に対応するシグネチャ情報を持っているかどうかを返します。

  • 形式

    public bool Has(string extension)
  • パラメータ

    名前 形式 説明
    extension System.String ファイルの拡張子の名前だ。
  • リターン

    指定された拡張子名に対応するシグネチャ情報があれば「true」、そうでなければ「false」を返します。

Check

  • シグネチャ検査を行い、その結果を「DEXTUpload.NET.FileSignatureResult」の値に戻します。

  • 形式

    public FileSignatureResult Check(string filePath)
    public FileSignatureResult Check(string extension, string filePath)
    public FileSignatureResult Check(string extension, FileStream stream)
    
  • パラメータ

    名前 形式 説明
    filePath System.String 検査しようとするファイルのパス(ローカルオペレーティングシステムのパス)である。
    extension System.String シグネチャ検査対象となる拡張子の名前だ。
    stream System.IO.FileStream 検査しようとするファイルから開かれた「FileStream」オブジェクトだ。
  • リターン

    検査結果を「DEXTUpload.NET.FileSignatureResult」の値に戻します。