Skip to main content
BuyLog In
ASP.NET Web Forms Controls
Search in…
Docs > Common Concepts > Web Farm and Web Garden Support > File Upload Support in a Web Farm and Web Garden
A newer version of this page is available. .
All docs
V19.2
ASP.NET Controls and MVC Extensions
Prerequisites
What's Installed
Common Concepts
Web.config Modifications
Callback Exception Handling
Client-Side Functionality
Cookies Support
Appearance Customization - Theming
Icon Collection
Performance Optimization
CSS Image Sprites
Data Annotation Attributes
Supported Document Types
Accessibility Support
Right to Left Support
HTML Encoding
SharePoint Support
Mobile Support
Office Document Management
Cloud Storage Account Management
Web Farm and Web Garden Support
File Upload Support in a Web Farm and Web Garden
Binary Storage Configuration
ASP.NET WebForms Controls
ASP.NET MVC Extensions
Localization
Redistribution and Deployment
Get More Help
.NET Framework API Reference
Client API Reference
Download CHM

File Upload Support in a Web Farm and Web Garden

  • 3 minutes to read

This topic describes how to implement file upload functionality in a clustered web environment (also known as a Web Farm or a Web Garden).

A Web Farm hosts a web application on multiple web servers, whereas a Web Garden runs an application on the same server - but in different worker processes. In a Web Garden, each worker process is executed on its own processor - specified by the Internet Information Services (IIS) settings of the server host where the application is deployed.

To implement file upload on a Web Farm or a Web Garden, customize the following settings.

Website Settings

The machineKey element in the web.config file should have the same settings for all websites in a Web Farm or Web Garden. Refer to the following Microsoft article for more information: How To: Configure MachineKey in ASP.NET 2.0.

Web Control Settings

If an instance of a website on a Web Farm/Web Garden uses an individual file system, utilize the following options to specify the file system parts that are shared for all website instances in the clustered web environment.

  1. Use the following settings to configure a temporary folder to store uploaded files.

    Web Control

    Settings

    ASPxUploadControl

    The ASPxUploadControl.AdvancedModeSettings.TemporaryFolder property is not used by default. It is used when the ASPxUploadControl.UploadMode property value is set to “Advanced” or “Auto”, and the ASPxUploadControl.UploadStorage property value is set to “NotSet” or “FileSystem”.

    The following code snippets illustrate how to specify the ASPxUploadControl.AdvancedModeSettings.TemporaryFolder property.

    ...
ASPxUploadControl.AdvancedModeSettings.TemporaryFolder = "//folder1"

...
//The "z" drive refers to a network folder. 
ASPxUploadControl.AdvancedModeSettings.TemporaryFolder = "z:\folder"

    ASPxFileManager

    The ASPxFileManager.SettingsUpload.AdvancedModeSettings.TemporaryFolder property is used by default when the FileManagerSettingsUpload.UseAdvancedUploadMode property is set to “true”.

    ASPxHtmlEditor

    The properties listed below are used by default when the ASPxHtmlEditorUploadSettingsBase.UseAdvancedUploadMode property of a specific selector is set to “true”:

    The following properties are used by default when the ASPxHtmlEditorUploadSettingsBase.UseAdvancedUploadMode property of a specific dialog is set to “true”:

    ASPxSpreadsheet

    The ASPxSpreadsheet.SettingsDocumentSelector.UploadSettings.AdvancedModeSettings.TemporaryFolder property is used by default when the ASPxHtmlEditorUploadSettingsBase.UseAdvancedUploadMode property is set to “true”.

    ASPxRichEdit

    The ASPxRichEdit.SettingsDocumentSelector.UploadSettings.AdvancedModeSettings.TemporaryFolder property is used by default when the ASPxHtmlEditorUploadSettingsBase.UseAdvancedUploadMode property is set to “true”.

    ASPxBinaryImage

    The ASPxBinaryImage.EditingSettings.UploadSettings.TemporaryFolder property is used by default when the BinaryImageUploadSettings.UploadMode property is set to “Auto”.

  2. Use the following settings to configure the folder that is used to store files after upload.

    Web Control

    Settings

    ASPxUploadControl

    The UploadControlFileSystemSettings.UploadFolder property is not used by default. It is in effect, however, when the ASPxUploadControl.UploadStorage property is set to “FileSystem”.

    ASPxHtmlEditor

    Customize the following properties if the ASPxHtmlEditorUploadSettingsBase.UploadStorage property is set to “FileSystem” for a specific dialog.