説明

HTTP リクエストでページに送信されたすべてのファイルを、サーバー上のディレクトリにアップロードします。

戻り値

ファイルのアップロードステータスを含む構造体の配列です。構造体に含まれる情報について詳しくは、cffileaction = "uploadAll" の「使用方法」の節を参照してください。

関数のシンタックス

FileUploadAll(destination,accept,nameConflict,continueOnError,errors)

履歴

ColdFusion 11:continueOnError および errors パラメーターが追加されました。

ColdFusion 9.0.1:この関数が追加されました。

パラメーター

パラメーター 必須 デフォルト 説明
destination 必須   ファイルのアップロード先となるディレクトリのパスです。絶対パス(ドライブ文字とコロン、あるいはスラッシュまたは円記号から始まるパス)を指定しない場合は、getTempDirectory 関数から返される ColdFusion テンポラリディレクトリを基準とする相対パスを指定します。
指定した宛先が存在しない場合は、指定された宛先の名前のファイルが作成されます。例えば、宛先 C:¥XYZ を指定した場合は、C: ドライブにファイル XYZ が作成されます。
accept オプション   受け入れる MIME タイプを制限します。カンマ区切りリストです。例えば、次のコードでは、JPEG ファイルと Microsoft Word ファイルのアップロードが許可されます。{{"image/jpg, application/msword"}} ブラウザは、ファイル名の拡張子に基づいてファイルタイプを判別します。
nameConflict オプション  Error

ファイル名がディレクトリ内のファイルと同じ場合に実行するアクションです。

  • Error:ファイルは保存されません。ColdFusion によりページの処理が停止され、エラーが返されます。
  • Skip:ファイルは保存されません。ファイルプロパティに基づいて、動作をカスタマイズできます。
  • Overwrite:ファイルを上書きします。
  • MakeUnique:アップロード用に固有のファイル名を作成します。この名前は、file オブジェクト変数 serverFile に保管されます。
continueOnError  オプション False

デフォルトでは、いずれかのファイルのアップロードに失敗した場合、残りのファイルはアップロードされません。この値を true に設定した場合、アップロードエラーの発生後もファイルのアップロードが継続されます。ファイルアップロードエラーは次の理由により発生します。

1. ファイルが空である
2.ファイルタイプが無効である
3.MIME または拡張子が無効である
4.ファイルが既に存在する

アップロードに失敗した場合、エラーの詳細が errors 属性に格納されます。

errors オプション  cffile.uploadAllErrors

 ファイルアップロードエラーが格納される変数の名前です。continueOnError が true の場合に、指定した名前の変数にエラーが設定されます。ファイルアップロードの完了後、このタグによって、アップロードの失敗ごとのアップロード失敗情報を含む構造体の配列が作成されます。

アップロード失敗情報のエラー構造体には次のフィールドが含まれます。

  • REASON - 失敗の理由です。
  • DETAIL - ファイルアップロード失敗の詳細です。
  • MESSAGE - 失敗を示す詳細メッセージです。
  • CLIENTFILE- クライアントのシステムからアップロードされたファイルの名前です。
  • CLIENTFILEEXT - クライアントシステム上のアップロードされたファイルの拡張子です(ピリオドは含みません)。
  • CLIENTFILENAME - クライアントシステム上のアップロードされたファイルの名前です(拡張子は含みません)。
  • INVALID_FILE_TYPE - ファイルの MIME タイプまたは拡張子が accept 属性に指定されていない場合。理由が INVALID_FILE_TYPE の場合、この構造体ではさらに次の 2 つのキーが利用可能です。
    • ACCEPT:このタグに指定された MIME タイプまたはファイル拡張子のリストです。
    • MIMETYPE:アップロードされたファイルの MIME タイプです。
  • EMPTY_FILE - アップロードされたファイルが空のファイルである場合。
  • FILE_EXISTS - 指定された名前のファイルが保存先に既に存在しており、overwritepolicy が error の場合
  • DEST - ファイルのコピー先です。
  • FORM_FILE_NOT_FOUND - アップロードされたファイルがサーバー上に見つからない場合。

関連項目

FileUpload

使用方法

cffile action = "uploadAll"

本作品は Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License によってライセンス許可を受けています。  Twitter™ および Facebook の投稿には、Creative Commons の規約内容は適用されません。

法律上の注意   |   プライバシーポリシー