<dextupload.net><settings>設定
「Web.config」ファイルの「dextupload.net」セクションの「settings」の要素は、コンポーネントがファイルのアップロードを処理する際に必要とされる基本的な情報を含んでいる。
「configSections」セクションに必ず「sectionGroup」を宣言して<dextupload.net>セクションを認識することができなければならない。
<?xml version="1.0"?> <configuration> <configSections> <!-- DEXTUpload.NET設定を読み取るためのセクションを定義する。 --> <sectionGroup name="dextupload.net"> <section name="settings" ... /> </sectionGroup> </configSections> <!-- DEXTUpload.NET Professional設定セクション --> <dextupload.net> <settings tempPath="~/files/temp" defaultPath="~/files/store" uploadTimeout="3600" maxFileLength="10485760" maxTotalLength="20971520" whiteExtensions="txt,jpg,png,gif,docx,xlsx,pptx,hwp,pdf,zip" availableNoFileExtension="true" filterAction="error" encoding="65001" compact="false" cleanerIntervalTime="60000" timeAgoForCleaning="24" enableCleaner="false" signatureDataFilePath="" methodFileSignatureChecking="noChecking" authkey="9Ubwly9EZZZhBENEep ... 省略 ... JyGxAJcB03gQQcM1Q"/> </dextupload.net> </configuration>
settings要素の属性に関する情報は、以下の通りである。
tempPath |
一時ファイルが生じるパスを設定する。 「〜」で起動すると、Webアプリケーションのルートを基準とする相対パスを意味し、ドライブ文字(C:\、D:\)を含むローカルパスや、UNCパス(\\)に設定ヘジュオヤする。 |
---|---|
defaultPath |
ファイルが保存されるデフォルトのパスを設定する。 「〜」で起動すると、Webアプリケーションのルートを基準とする相対パスを意味し、ドライブ文字(C:\、D:\)を含むローカルパスや、UNCパス(\\)に設定ヘジュオヤする。 デフォルトでは、「tempPath」と同じである。 |
uploadTimeout |
要求の制限時間(秒)を設定する。 コンポーネントを介して処理がされる要求にのみ制限される。 デフォルトは3600秒であり、デバッグ環境では、効力がない。 |
maxFileLength |
個々のファイルの最大許容サイズ(byte単位)を設定する。 デフォルト値は-1であり、ファイルのサイズを制限しない。 リクエストデータの制限は、「maxFileLength「設定値よりもIIS自体要求の制限値を優先し、「maxFileLength」は、要求データの制限ではなく、要求データ中のファイルのエントリのサイズの制限ポリシーである。 |
maxTotalLength |
アップロードされたすべてのファイルのサイズを加えたときの最大許容サイズ(byte単位)を設定する。 デフォルト値は-1であり、ファイルのサイズを制限しない。 リクエストデータの制限は、「maxTotalLength「設定値よりもIIS自体要求の制限値を優先し、「maxTotalLength」の設定は、大容量のファイルのアップロード環境(2GB以上)で無視される。 |
whiteExtensions |
アップロードが許可されている拡張子のリストを設定する。 コンマ(、)で区切らをし、デフォルトでは拡張子制限をしていない。 |
availableNoFileExtension |
拡張子のないファイルのアップロードを許可する(true、false)かを設定する。 デフォルト値はtrueである。 |
filterAction |
現在のリクエストで、サイズと拡張子制限によるフィルタリング対象がある場合の処理方法を設定する。 「error」:フィルタリング対象が見つかった場合、エラーを発生させる。 「flushing」:フィルタリング対象が見つかった場合、ターゲットを0バイトのファイルとして保存する。 デフォルトでは、「error」である。 |
encoding |
コンポーネント内部で文字列データを処理する際に使用する文字セットを設定する。 デフォルトは「utf-8」である。 |
compact |
ファイルのサイズが0または空の場合、そのフォームのフィールドを完全に除去することができる。 デフォルトでは、「false」である。 |
cleanerIntervalTime |
クリーナーが削除操作をするイベントの時間間隔を設定する。 単位はミリ秒(1/1000)であり、1分下に指定することができません。」Int32.MaxValue」よりも小さいか同じである。 デフォルト値は、60000ms(1分)である。 |
timeAgoForCleaning |
削除、一時ファイルの基準となる時間(hour)を設定する。 時間(hour)単位であり、値は1よりも大きく、「Int32.MaxValue」よりも小さいか同じである。 デフォルトは24です。 |
enableCleaner |
クリーナーが一時ファイルを定期的に削除するかを取得または設定します。 「enableCleaner」属性を「true」に設定すると、最初のファイルのアップロードが開始されると、内部的にクリーナーが開始される。 クリーナーは「cleanerIntervalTime、timeAgoForCleaning「属性の指定値またはデフォルト値を持っている一時フォルダ(ディレクトリ)に存在する一時ファイルを削除する準備をする。 たとえば、「cleanerIntervalTime」の値が60000であり、「timeAgoForCleaning」の値が24であれば、1分ごとに「tempPath」属性が指す一時フォルダから、最近の変更日付が24時間前(含む)のすべての一時ファイルのリソースを削除する。 大容量ファイルのアップロードの場合、一時ファイルが存在すれば、数日が過ぎても続いて上げるが可能である。しかし、クリーナーが動作するようになれば、「timeAgoForCleaning」属性で指定された時間が経過ファイルはすべて削除される。 「DEXTUpload.NET.FileUpload「オブジェクトの「Dispose」メソッドが呼び出されると、一時ファイルを削除する機能がありますが、このような措置を超えてファイルであるか、大容量のファイルのアップロードの過程で発生したジャンクファイルを削除する目的でクリーナーを使用する。 加えて「DEXTUpload.NET.FileElement「クラスの「Keep」メソッドを使用して一時ファイルをそのまま使用するように設定してもクリーナーは対象を削除する。 多数のWebアプリケーションの1つの一時フォルダを共有する場合にクリーナーを使用すると、複数のプロセスが一時ファイルを削除する過程で、I / Oの競合の問題が発生することができる。 デフォルトでは、「false」である。 |
signatureDataFilePath(5.2.0.0バージョンからサポート) |
シグネチャ検査をするために必要とされるシグネチャリソースファイルのパスを取得または設定します。 シグネチャのリソースファイルは、ファイルのシグネチャ検査を実行するために必要なファイルとして、基本的なリソースは、コンポーネント自体に含まれているが、「signatureDataFilePath」属性にパスが設定されると、内部リソースではなく、与えられたパスのファイルをリソースとして使用してシグネチャ検査を行うことになる。 デフォルトでは、「null」である。 |
methodFileSignatureChecking(5.2.0.0バージョンからサポート) |
シグネチャを検査する方法を取得または設定します。 属性が設定されない場合、デフォルト値が「noChecking」であるため、シグネチャチェックを実行していない。 詳細については、シグネチャ検査項目を参照する。 |
authkey |
発行された認証キーを設定する。 |
「tempPath」と「authkey」を除いた他の属性はすべて省略することができる。
<?xml version="1.0"?> <configuration> <configSections> <sectionGroup name="dextupload.net"> <section name="settings" ... /> </sectionGroup> </configSections> <dextupload.net> <settings tempPath="~/files/temp" authkey="9Ubwly9EZZZhBENEep ... JyGxAJcB03gQQcM1Q"/> </dextupload.net> </configuration>