public class UploaderBase : AjaxFileUpload, IComponent, IDisposable, IParserAccessor, IUrlResolutionService, IDataBindingsAccessor, IControlBuilderAccessor, IControlDesignerAccessor, IExpressionsAccessor, IAttributeAccessor, IPostBackDataHandler, IAjaxUploader

Constructors

UploaderBase()

Initializes a new instance of the UploaderBase class.

Declaration

public UploaderBase()

Fields

SharedStyleText

v4 parity: shared stylesheet text the legacy control emitted once per page. v5 ships its CSS as a static web asset, so there is no inline style block to hand back; the field exists so v4 code that reads or assigns it still compiles and runs.

Declaration

public static string SharedStyleText

Field Value

Type	Description
string

UPLOAD_EXTENSION

v4 parity: extension used for the temp metadata file written alongside an upload. Kept as a constant because v4 code composes paths with it.

Declaration

public const string UPLOAD_EXTENSION = "resx"

Field Value

Type	Description
string

Properties

AutoUseSystemTempFolder

Gets or sets whether the legacy control should prefer the system temporary folder.

Declaration

public bool AutoUseSystemTempFolder { get; set; }

Property Value

Type	Description
bool

ButtonOnClickScript

Declaration

public string ButtonOnClickScript { get; set; }

Property Value

Type	Description
string

CancelAllMsg

Declaration

public string CancelAllMsg { get; set; }

Property Value

Type	Description
string

CancelButtonID

Declaration

public string CancelButtonID { get; set; }

Property Value

Type	Description
string

CancelUploadMsg

Declaration

public string CancelUploadMsg { get; set; }

Property Value

Type	Description
string

DialogAccept

Declaration

public string DialogAccept { get; set; }

Property Value

Type	Description
string

DialogFilter

Declaration

public string DialogFilter { get; set; }

Property Value

Type	Description
string

DropZoneID

Declaration

public string DropZoneID { get; set; }

Property Value

Type	Description
string

EmitLegacyClientApi

Forwards the v4 per-control message properties to the client engine.

Declaration

protected override bool EmitLegacyClientApi { get; }

Property Value

Type	Description
bool

Overrides

AjaxFileUpload.EmitLegacyClientApi

Remarks

v4 rendered these strings itself, so setting UploadingMsg or FileTooLargeMsg changed what the user saw. In v5 the text comes from the engine's shared locale packs, and these properties stored to ViewState and were never read - so an upgraded v4 site that had translated its uploader silently reverted to English with no error.

The placeholder conventions differ: v4 used positional {0}/{1}, the engine uses named tokens. Each message is translated below rather than passed through, which would have rendered a literal "{0}" to the user. Only non-empty values are forwarded, so a page that customises one message keeps the active translation for the rest.

FileTooLargeMsg

Declaration

public string FileTooLargeMsg { get; set; }

Property Value

Type	Description
string

FileTypeNotSupportMsg

Declaration

public string FileTypeNotSupportMsg { get; set; }

Property Value

Type	Description
string

FlashLoadMode

Declaration

public bool FlashLoadMode { get; set; }

Property Value

Type	Description
bool

FlashUploadPage

Declaration

public string FlashUploadPage { get; set; }

Property Value

Type	Description
string

FlashWarningImage

Declaration

public string FlashWarningImage { get; set; }

Property Value

Type	Description
string

InputboxCSSText

Declaration

public string InputboxCSSText { get; set; }

Property Value

Type	Description
string

InsertButtonID

Declaration

public string InsertButtonID { get; set; }

Property Value

Type	Description
string

InsertText

Gets or sets the browse button caption shown by the legacy uploader.

Declaration

public string InsertText { get; set; }

Property Value

Type	Description
string

ManualStartUpload

Gets or sets whether uploads must be started manually.

Declaration

public bool ManualStartUpload { get; set; }

Property Value

Type	Description
bool

MaxFilesLimit

Gets or sets the legacy maximum file count. A value of -1 means unlimited.

Declaration

public int MaxFilesLimit { get; set; }

Property Value

Type	Description
int

MaxFilesLimitMsg

Declaration

public string MaxFilesLimitMsg { get; set; }

Property Value

Type	Description
string

MultipleFilesUpload

Gets or sets whether the control allows multiple files to be selected.

Declaration

public bool MultipleFilesUpload { get; set; }

Property Value

Type	Description
bool

NumFilesShowCancelAll

Declaration

public int NumFilesShowCancelAll { get; set; }

Property Value

Type	Description
int

NumFilesShowQueueUI

Declaration

public int NumFilesShowQueueUI { get; set; }

Property Value

Type	Description
int

ProgressBarBackgroundImage

Declaration

public string ProgressBarBackgroundImage { get; set; }

Property Value

Type	Description
string

ProgressBarBorderStyle

Declaration

public string ProgressBarBorderStyle { get; set; }

Property Value

Type	Description
string

ProgressBarColor

Declaration

public string ProgressBarColor { get; set; }

Property Value

Type	Description
string

ProgressBarHeight

Declaration

public int ProgressBarHeight { get; set; }

Property Value

Type	Description
int

ProgressBarStyle

Declaration

public ProgressBarType ProgressBarStyle { get; set; }

Property Value

Type	Description
ProgressBarType

ProgressCtrlID

Declaration

public string ProgressCtrlID { get; set; }

Property Value

Type	Description
string

ProgressInfoStyle

Declaration

public string ProgressInfoStyle { get; set; }

Property Value

Type	Description
string

ProgressPanelWidth

Declaration

public int ProgressPanelWidth { get; set; }

Property Value

Type	Description
int

ProgressPicture

Declaration

public string ProgressPicture { get; set; }

Property Value

Type	Description
string

ProgressTextID

Declaration

public string ProgressTextID { get; set; }

Property Value

Type	Description
string

ProgressTextTemplate

Declaration

public string ProgressTextTemplate { get; set; }

Property Value

Type	Description
string

QueuePanelID

Declaration

public string QueuePanelID { get; set; }

Property Value

Type	Description
string

ShowFrameBrowseButton

Declaration

public bool ShowFrameBrowseButton { get; set; }

Property Value

Type	Description
bool

ShowProgressBar

Gets or sets whether the progress bar area is displayed.

Declaration

public bool ShowProgressBar { get; set; }

Property Value

Type	Description
bool

ShowProgressInfo

Declaration

public bool ShowProgressInfo { get; set; }

Property Value

Type	Description
bool

ShowQueueTable

Gets or sets whether the queue table is displayed.

Declaration

public bool ShowQueueTable { get; set; }

Property Value

Type	Description
bool

TempDirectory

Gets or sets the temporary upload directory used by the compatibility layer.

Declaration

public string TempDirectory { get; set; }

Property Value

Type	Description
string

UploadAddonButtonImage

Declaration

public string UploadAddonButtonImage { get; set; }

Property Value

Type	Description
string

UploadAddonButtonMode

Declaration

public UploadAddonButtonMode UploadAddonButtonMode { get; set; }

Property Value

Type	Description
UploadAddonButtonMode

UploadAddonButtonShowText

Declaration

public bool UploadAddonButtonShowText { get; set; }

Property Value

Type	Description
bool

UploadAddonWarningImage

Declaration

public string UploadAddonWarningImage { get; set; }

Property Value

Type	Description
string

UploadCursor

Declaration

public UploadCursor UploadCursor { get; set; }

Property Value

Type	Description
UploadCursor

UploadProcessingMsg

Declaration

public string UploadProcessingMsg { get; set; }

Property Value

Type	Description
string

UploadType

Declaration

public UploadType UploadType { get; set; }

Property Value

Type	Description
UploadType

UploadTypePriority

Declaration

public string UploadTypePriority { get; set; }

Property Value

Type	Description
string

UploaderDebug

Declaration

public string UploaderDebug { get; set; }

Property Value

Type	Description
string

UploadingMsg

Declaration

public string UploadingMsg { get; set; }

Property Value

Type	Description
string

ValidateOption

Gets the legacy validation settings object.

Declaration

[PersistenceMode(PersistenceMode.InnerProperty)]
public UploaderValidateOption ValidateOption { get; }

Property Value

Type	Description
UploaderValidateOption

WindowsDialogLimitMsg

Declaration

public string WindowsDialogLimitMsg { get; set; }

Property Value

Type	Description
string

Methods

CheckPostBackData()

v3/v4 parity: forces the uploader to process its posted GUID list if ASP.NET has not already done so, and raises the legacy events.

Declaration

public void CheckPostBackData()

Remarks

In v4 this was the documented escape hatch for pages where the automatic post-data path did not run - Util.CheckPostBackData read Request.Form[UniqueID] directly and called ProcessPostBackData. This used to be an empty stub, so v4 code calling it got silence: the upload succeeded and no handler ever ran. Idempotent - ASP.NET's own LoadPostData path already populated the list, and the base guards against re-raising events for files it has handled.

GetAdvancedOption(UploaderAdvancedOption)

Returns the stored value for a legacy advanced option flag.

Declaration

public string GetAdvancedOption(UploaderAdvancedOption name)

Parameters

Type	Name	Description
UploaderAdvancedOption	name

Returns

Type	Description
string

GetBrowserType()

Gets the current browser name from the active HTTP request.

Declaration

public string GetBrowserType()

Returns

Type	Description
string

GetBrowserVersion()

Gets the current browser version from the active HTTP request.

Declaration

public decimal GetBrowserVersion()

Returns

Type	Description
decimal

GetClientElementBindings()

v4 parity: forwards the element-binding IDs to the engine.

Declaration

protected override IDictionary<string, string> GetClientElementBindings()

Returns

Type	Description
IDictionary<string, string>

Overrides

AjaxFileUpload.GetClientElementBindings()

Remarks

Only InsertButtonID has a true engine counterpart (browseButton, which also hides the built-in button). ProgressCtrlID / ProgressTextID / CancelButtonID / QueuePanelID named v4's own progress chrome, which v5 renders differently; they stay inert rather than being mapped onto something that only half behaves. DropZoneID is handled by the base control's own property.

GetClientStringOverrides()

Returns per-instance client string overrides to merge into the engine's strings option, or null for none.

Declaration

protected override IDictionary<string, string> GetClientStringOverrides()

Returns

Type	Description
IDictionary<string, string>

Overrides

AjaxFileUpload.GetClientStringOverrides()

Remarks

The modern control has no per-control message properties, so this returns nothing; the legacy CuteWebUI controls override it to forward their v4 message properties.

GetTempDirectory()

Gets the resolved temporary upload directory.

Declaration

public string GetTempDirectory()

Returns

Type	Description
string

GetUploadedFile(Guid)

Resolves an uploaded file by GUID and wraps it in the legacy MVC helper type.

Declaration

public MvcUploadFile GetUploadedFile(Guid guid)

Parameters

Type	Name	Description
Guid	guid

Returns

Type	Description
MvcUploadFile

GetUploaderProvider()

Creates a legacy provider wrapper for accessing uploaded files.

Declaration

public UploaderProvider GetUploaderProvider()

Returns

Type	Description
UploaderProvider

Impersonate()

Returns a disposable impersonation scope placeholder kept for compatibility.

Declaration

public IDisposable Impersonate()

Returns

Type	Description
IDisposable

OnInit(EventArgs)

v4 (CuteWebUI) parity: the legacy Uploader posted back automatically when the upload batch finished, so FileUploaded / UploadCompleted fired with no submit button on the page. The modern base posts back automatically when a server upload event is handled. The legacy control continues to enforce that v4 behavior. Without this, upgraded v4 code uploads successfully but its FileUploaded handler never runs — the classic "saves nothing" report.

Declaration

protected override void OnInit(EventArgs e)

Parameters

Type	Name	Description
EventArgs	e

Overrides

Control.OnInit(EventArgs)

OnPreRender(EventArgs)

Raises the PreRender event.

Declaration

protected override void OnPreRender(EventArgs e)

Parameters

Type	Name	Description
EventArgs	e	An EventArgs object that contains the event data.

Overrides

AjaxFileUpload.OnPreRender(EventArgs)

RaiseLegacyFileUploaded(Guid, string, int)

Declaration

protected void RaiseLegacyFileUploaded(Guid guid, string fileName, int fileSize)

Parameters

Type	Name	Description
Guid	guid
string	fileName
int	fileSize

RaiseLegacyUploadCompleted(IEnumerable<Guid>)

Declaration

protected void RaiseLegacyUploadCompleted(IEnumerable<Guid> guids)

Parameters

Type	Name	Description
IEnumerable<Guid>	guids

SetAdvancedOption(UploaderAdvancedOption, string)

Stores a legacy advanced option flag value.

Declaration

public void SetAdvancedOption(UploaderAdvancedOption name, string value)

Parameters

Type	Name	Description
UploaderAdvancedOption	name
string	value

SetValidationServerData(string)

Stores custom validation data that is later exposed through ClientData.

Declaration

public void SetValidationServerData(string data)

Parameters

Type	Name	Description
string	data

Upload(int, string, Stream)

Uploads a file stream through the v5 backend and raises the legacy events.

Declaration

public void Upload(int filesize, string filename, Stream stream)

Parameters

Type	Name	Description
int	filesize
string	filename
Stream	stream

Upload(int, string, string)

Uploads a temporary file path through the v5 backend and raises the legacy events.

Declaration

public void Upload(int filesize, string filename, string temppath)

Parameters

Type	Name	Description
int	filesize
string	filename
string	temppath

Events

FileUploaded

Occurs after an individual file has uploaded successfully.

Declaration

public event UploaderEventHandler FileUploaded

Event Type

Type	Description
UploaderEventHandler

FileValidating

Occurs before a file is accepted by the server-side validation pipeline.

Declaration

public event UploaderEventHandler FileValidating

Event Type

Type	Description
UploaderEventHandler

OnInstanceInit

v4 parity: raised once the uploader instance has been initialised. v5 raises it at the end of OnInit, which is the same point in the page lifecycle the legacy control used.

Declaration

public event EventHandler OnInstanceInit

Event Type

Type	Description
EventHandler

UploadCompleted

Occurs after the current batch of uploaded files has completed.

Declaration

public event UploaderBatchEventHandler UploadCompleted

Event Type

Type	Description
UploaderBatchEventHandler

Implements

IComponent

IDisposable

IParserAccessor

IUrlResolutionService

IDataBindingsAccessor

IControlBuilderAccessor

IControlDesignerAccessor

IExpressionsAccessor

IAttributeAccessor

IPostBackDataHandler

IAjaxUploader