New to Telerik UI for ASP.NET AJAXStart a free 30-day trial

Server-Side Programming Overview

This article provides a list and detailed description of the properties and methods that you can use with the RadAsyncUpload control. For the full list visit the RadAsyncUpload class article.

Properties

NameTypeDescription
AccessKeystringSets or returns a String that represents the shortcut key, also known as the accelerator key, for a specified object.
AllowedFileExtensionsstringGets or sets the allowed file extensions for uploading.
ChunkSizeintGets or sets the size of the uploading chunks in bytes.
DisableChunkUploadboolGets or sets whether the upload will be in chunks (2MB each) or the file will be uploaded with one request.
DisablePluginsboolSpecify whether RadAsyncUpload will use 3rd party plugins like Flash/Silverlight or will stick to the native modules only (IFrame, File API).
DropZonesstringGets or sets the drop zones for upload.
EnabledboolEnable or disable the RadAsyncUpload control.
EnableEmbeddedBaseStylesheetboolGets or sets the value, indicating whether to render the link to the embedded base stylesheet of the control or not.
EnableEmbeddedScriptsboolGets or sets the value, indicating whether to render script references to the embedded scripts or not.
EnableEmbeddedSkinsboolGets or sets the value, indicating whether to render links to the embedded skins or not.
EnableFileInputSkinningboolGets or sets the value indicating whether the file input fields skinning will be enabled.
EnableInlineProgressboolSpecifies whether RadAsyncUpload displays an inline progress next to each file being uploaded.
EnablePermissionsCheckboolSpecifies whether RadAsyncUpload performs check for write permissions upon load.
HideFileInputboolGets or sets whether to render the file input.
HttpHandlerUrlstringSpecifies the URL of the custom upload HTTP Handler.
InputSizeintGets or sets the size of the file input field.
IsSkinSetboolFor internal use.
LocalizationAsyncUploadStringsGets the localization.
LocalizationPathstringGets or sets a string value indicating where RadAsyncUpload will look for its .resx localization files.
ManualUploadboolGets or sets whether the upload will start automatically after the files are selected.
MaxFileInputsCountintGets or sets the maximum file input fields that can be added to the control in single selection mode. MultipleFileSelection is not supported out of the box.
MaxFileSizeintGets or sets the maximum file size allowed for uploading in bytes.
MultipleFileSelectionAsyncUpload.MultipleFileSelectionGets or sets a value indicating whether RadAsyncUpload allows selecting multiple files in the File Selection dialog.
OnClientAddedstringGets or sets the name of the client-side function which will be executed after a new fileinput is added to a RadUAsyncpload instance.
OnClientFileDroppedstringGets or sets the name of the client-side function which will be executed after a file has been dropped.
OnClientFileSelectedstringGets or sets the name of the client-side function which will be executed after a file has been selected.
OnClientFilesSelectedstringGets or sets the name of the client-side function which will be executed after files have been selected.
OnClientFilesUploadedstringGets or sets the name of the client-side function which will be executed all selected files have been uploaded.
OnClientFileUploadedstringGets or sets the name of the client-side function which will be executed when a file upload finishes successfully.
OnClientFileUploadFailedstringGets or sets the name of the client-side function which will be executed when a file upload ends unsuccessfully.
OnClientFileUploadingstringGets or sets the name of the client-side function which will be executed when a file upload starts.
OnClientFileUploadRemovedstringGets or sets the name of the client-side function which will be executed after a file input has been deleted from a RadAsyncUpload instance.
OnClientFileUploadRemovingstringGets or sets the name of the client-side function which will be executed before a file input is deleted from a RadAsyncUpload instance.
OnClientProgressUpdatingstringGets or sets the name of the client-side function which will be executed on an in-line progress update.
OnClientValidationFailedstringGets or sets the name of the client-side function which will be executed if the selected file has invalid extension.
PersistConfigurationboolGets or sets whether the upload configuration should be persisted into ControlState (if the upload configuration is different than null).
PostbackTriggersstringGets or sets whether the client state should be persisted (if the postback is triggered by particular control).
ProgressHandlerUrlstringGets or sets the URL which for the progress handler that takes care of the progress monitoring when the IFrame module is used.
RegisterWithScriptManagerboolWhether to register with the ScriptManager control on the page.
RenderModeRenderModeSpecifies the rendering mode of the control.
SkinstringSpecifies the skin that will be used by the control.
TabIndexshortGets or sets the tab order of the control within its container.
TargetFolderstringGets or sets the virtual path of the folder, where RadAsyncUpload will automatically save the valid files after the upload completes.
TemporaryFileExpirationTimeSpanSets how long temporary files should be kept before automatically deleting them. The default value is 4 hours.
TemporaryFolderstringGets or sets the path to a folder where RadAsyncUpload should save files temporarily until a postback occurs. Defaults to App_Data\RadUploadTemp subfolder of the Application Path.
UploadConfigurationIAsyncUploadConfigurationSets upload configuration. The generic object can be obtained using the CreateUploadConfiguration<T> method, where T is custom class that implements IAsyncUploadConfiguration. If you use this, see Security - Custom Metadata.
UploadedFilesUploadedFileCollectionProvides access to the valid files uploaded by the RadAsyncUpload instance.
UploadedFilesRenderingAsyncUpload.UploadedFilesRenderingGets or sets a value indicating whether RadAsyncUpload will render the uploaded files above/below the current file input.
UseApplicationPoolImpersonationboolGets or sets whether the application pool impersonation should be used.

The LastModifiedDate property was added to the AsyncUploadedFile class as of Q3 2012. The value is available only when we are uploading files with IE10, FireFox, Google Chrome and Safari browsers. In IE9 it is not available because it does not support File API while in Opera, LastModifiedDate is not available due to security reasons.

Methods

NameDescription
CreateDefaultUploadConfiguration<T>Creates an object of type T (that implements IAsyncUploadConfiguration) and populates all properties specified in the interface from this RadAsyncUpload instance.

Properties of the UploadedFiles Collection

NameTypeDescription
ContentLengthintGets the size in bytes of an uploaded file.
ContentTypestringGets the MIME content type of a file sent by a client.
FileNamestringGets the fully-qualified name of the file on the client's computer (for example "C:\MyFiles\Test.txt").
InputStreamSystem.IO.StreamGets a Stream object which points to the uploaded file to prepare for reading the contents of the file. The property is available only in RadAsyncUpload control when FileApi module is used.
LastModifiedDateDateTimeGets the last modified date of the uploaded file. The property is available only in RadAsyncUpload control when FileApi module is used.

Methods of the UploadedFiles Collection 

NameDescription
GetExtensionReturns the extension of the file on the client's computer.
GetFieldValueReturns the value of a custom field.
GetIsFieldCheckedReturns the checked state of a custom field.
GetNameReturns the name and extension of the file on the client's computer.
GetNameWithoutExtensionReturns the name of the file on the client's computer without the extension.
SaveAsSaves the contents of an uploaded file.

See Also