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

DEXTUpload.NET
Class FileSaveOption

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

「FileSaveOption」は「DEXTUpload.NET.IFileManagement」インターフェースの「Save」または「SaveAs」メソッドを使用するときに必要な設定を持っているクラスです。

using (var dext = new FileUpload())
{
    var element = dext.GetFileElement("file1");
    //一時ファイルを保存するとき、上書きを行わないため、同じファイル名が存在する場合、ファイル名の後ろにsuffixが付く。
    //加えSaveメソッドを呼び出した後でも、一時ファイルは削除されない。
    element.Save("~/files/store/subdir", new FileSaveOption { 
        Copying = true, 
        IsOverwrite = false,
        CheckingFreeSize = true
    });

    // usingステートメントの外に出ると「FileUpload」オブジェクトは、現在のリクエスト中に残って一時ファイルを削除する。
}
形式
public class FileSaveOption
コンストラクタ

FileSaveOption

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

  • 形式

    public FileSaveOption()
    public FileSaveOption(bool overwrite) (5.1.0.0バージョンからサポート)
    public FileSaveOption(bool overwrite, bool copy)
    public FileSaveOption(bool overwrite, bool copy, bool freesize) (5.1.0.0バージョンからサポート)
  • パラメータ

    名前 形式 説明
    overwrite System.Boolean 同じファイル名を持つファイルである場合は上書きする場合は「true」である。
    copy System.Boolean ファイルを保存した後、削除せずに維持するには、「false」である。
    freesize System.Boolean ファイルのコピー元のディスク容量を確認するには、「true」である。
属性

IsOverwrite

  • ファイルを保存するときは、先に同じ名前のファイルがある場合は、上書きするかどうかを取得または設定します。

    上書きは対象を削除して、同じ名前でビンをいう。デフォルトでは、「true」なので、同じファイル名を持つファイルがある場合は、対象を削除して、同じ名前で保存する。値が「false」に設定すると、同じファイル名を持つファイルが存在する場合、ファイルを保存するときに、ファイル名の後ろに数字のsuffixが付くようになる。

    多数のプロセスやスレッドで同時に同じ名前を持つファイルを作成するときにクラッシュが発生することができる。

  • 形式

    public bool IsOverwrite { get; set; }

Copying

  • 一時ファイルを保存したい場所に移動またはコピーした後、一時ファイルを削除するかどうかを取得または設定します。

    値が「true」であれば、コピーが可能必要があるため、一時ファイルを削除しない。加えて「Copying」オプションが適用される範囲は、「DEXTUpload.NET.FileUpload」オブジェクトが「Dispose」メソッドを呼び出していない時点まで有効である。

    デフォルトでは、「false」である。

  • 形式

    public bool Copying { get; set; }

CheckingFreeSize (5.1.0.0バージョンからサポート)

  • ディスク領域のサイズをチェックして、最終的なコピー操作を行うかどうかを取得または設定します。

    ファイルが移動ではなく、コピーが行われるとき、ターゲットディスクの容量をチェックして、空き領域がある場合にのみ、コピー操作を行い、スペースに余裕がない場合は、例外が発生する。デフォルトでは、「true」である。

    ディスクの空き容量のチェックが失敗する環境があるときは「CheckingFreeSize」属性を「false」に設定して、事前検査の作業を省略するようにしなければならない。

  • 形式

    public bool CheckingFreeSize { get; set; }