<script type="text/javascript" language="javascript"> function fileSelecting(e, args) { } </script> <igjq:WebUpload ID="webUpload1" runat="server"> <ClientEvents FileSelecting="fileSelecting"/> </igjq:WebUpload>
WebUpload コントロールは、多くのイベントを装備するリッチ クライアント側 API 機能を公開します。7 種類のクライアント側イベントがあります。これらは、ユーザーがコントロールを操作している時やアップロード処理中に発生します。
WebUpload の ClientEvents タグに関数名を定義してハンドラーを添付します。次に、イベントを処理するために同じ値で JavaScript 関数を作成する必要があります。
たとえば、fileSelecting イベントを検討してください。このイベントについては「クライアント イベント」 セクションで後述します。
添付されたハンドラー内で、必要なロジックを実装できます。このためにイベントの属性を使用できます。これはすべてのイベントに同じ名前が付けられます。イベントには - e、引数には args です。イベントによっては、 args 引数に異なるプロパティセットが含まれる場合があります。
注: イベントをキャンセルしたい場合 (キャンセル可能なイベントは、fileSelecting および fileUploading)、関数から false を返す必要があるだけです。注: イベントをキャンセルしたい場合(キャンセル可能なイベントは、fileSelecting および fileUploading )、関数から false を返す必要があるだけです。
表 1: igUpload コントロールで使用できるクライアント イベント
以下の表は、サーバーから返されるメッセージ コードとそれに対応する意味です。
表 2: タイプ * UploadStatus の列挙体
表 3: タイプ * FileError の列挙体(サーバー側のエラー)
表 4: タイプ FileError の列挙体(クライアント側のエラー コード)