Gets or sets value that indicating whether incoming request should be read if an exception is occurred.

Namespace:  EasyAlgo.EAUpload
Assembly:  EasyAlgo.EAUpload (in EasyAlgo.EAUpload.dll)
Version: 1.3.1.0

Syntax

C#
public bool ProcessRequestOnError { get; set; }
Visual Basic (Declaration)
Public Property ProcessRequestOnError As Boolean

Field Value

Type: System..::.Boolean
true if incoming request should be read when an exception is occurred; otherwise false. Default value is false.

Remarks

This property is a reflection of EAUpload configuration parameter (<EasyAlgo.EAUpload>/<Exceptions ... ProcessRequestOnError="" ... >).

If exception occurs during upload and the request is not read entirely then user will get "White page" or "The page cannot be displayed" error message in his browser. There is no way to send a response to the client(browser) without reading whole request. Therefore, if you want to redirect user to a custom error page then you should specify this property as true.

The following table describes how the logic of exceptions processing during request reading depends on ProcessRequestOnError and ThrowErrorsImmediately properties:
ProcessRequestOnErrorThrowErrorsImmediatelyDefined logic
falsetrue
  1. Exception is written to LastError property.
  2. Connection is closed (Session is not terminated).
  3. If UploadEnvironment.WriteToSystemEventLog property or WriteToSystemEventLog parameter is true then error is written to System Event log.
  4. EAUploadModule.UploadError event is fired.
  5. All specified redirection is ignored.
  6. EAUploadException is thrown.
falsefalse
  1. Exception is written to LastError property.
  2. Connection is closed (Session is not terminated).
  3. If UploadEnvironment.WriteToSystemEventLog property or WriteToSystemEventLog parameter is true then error is written to System Event log.
  4. EAUploadModule.UploadError event is fired.
  5. All specified redirection is ignored.
  6. EAUploadException is not thrown.
truetrue
  1. Exception is written to LastError property.
  2. Request is read to end.
  3. Files, that had not been uploaded before exception, are being written to RejectedFileCollection
  4. If UploadEnvironment.WriteToSystemEventLog property or WriteToSystemEventLog parameter is true then error is written to System Event log.
  5. EAUploadModule.UploadError event is fired.
  6. Client is redirected to a custom error page if it is defined; otherwise point 6.
  7. EAUploadException is thrown.
truefalse
  1. Exception is written to LastError property.
  2. Request is read to end.
  3. Files, that had not been uploaded before exception, are being written to RejectedFileCollection
  4. If UploadEnvironment.WriteToSystemEventLog property or WriteToSystemEventLog parameter is true then error is written to System Event log.
  5. EAUploadModule.UploadError event is fired.
  6. Client is redirected to a custom error page if it is defined; otherwise no action.
  7. EAUploadException is not thrown.


Note:The property value doesn't affects on processing execution timeout exception (Exception message: "Upload request timed out.")


Note:If you want to change this property at the runtime, you can define its at the Initializing stage or at the Uploading stage of an upload (see EasyAlgo.EAUpload..::.UploadState for more information). Also if you have change this property for the whole of EAUpload component (EAUploadModule..::.CommonEnvironment property), then new value will take effect for the all processing and new uploads.

See Also