アイテムの数とサイズを制限する

ホーム > 基本的な例 > 例08

説明

アップロードするファイル数、個別サイズ、合計サイズの制限を設定できます。

何も設定しない場合は、デフォルトで制限されません。(サイズ無制限のアップロードをサポートするわけではありません)

var dx = dx5.get("component-id");

// 許容ファイル数を返す。制限がない場合は-1が返される。
var maxCount = dx.getMaxFileCount();

// 仮想ファイルを除き、合計5ファイルまで許可する設定。
dx.setMaxFileCount(5, false);

// 許可されるファイル全体のサイズを返す。制限がない場合は-1が返される。
var maxTotalSize = dx.getMaxTotalSize();

// 許可されるファイルサイズの合計を、仮想ファイルを除いて100MBに設定する。
dx.setMaxTotalSize(104857600, false);

// 個別ファイルの最大サイズを返す。制限がない場合は-1が返される。
var maxSize = dx.getMaxFileSize();

// 個別ファイルの最大サイズを10MBに設定する。
dx.setMaxFileSize(10485760);

// 個別ファイルの最小サイズを返す。制限がない場合は-1が返される。
var minSize = dx.getMinFileSize();

// 個別ファイルの最小サイズを1MBに設定。
dx.setMinFileSize(1048576);

例

ファイルの総数を制限することができます。値が-1の場合は制限を行いません。
総ファイル数を制限しない場合でも、ファイル数が多いとメモリを使いすぎたり、パソコンのスペックによってはコンポーネントの動作が遅くなることがあります。
確実なサービス運用のためには、ファイル総数を制限する（比較的少なくする）ことをお勧めします。

ファイル全体のサイズを制限することができます。値が -1 の場合は制限を行いません。
ファイル全体のサイズを制限しない場合でも、送信データ（ファイル＋その他の情報）のサイズが2GBを超える場合は、サーバー側で制限することができます。
特殊な用途を除き、確実なサービス運用のためには、ファイル全体のサイズを制限する（比較的小さくする）ことを推奨します。

個々のファイルサイズの上限を制限することができます。値が -1 の場合、制限は行われません。
個々のファイルサイズを制限しない場合でも、転送されるデータ（ファイル＋その他の情報）のサイズが2GBを超えると、サーバー側で制限される場合があります
特殊な用途を除き、安定したサービス運用のためには、個々のファイルサイズを制限する（相対的に小さくする）ことを推奨します。

個別ファイルサイズの最小値を制限することができます。値が-1の場合は制限を行いません。