This documentation is archived and is not being maintained.

ProcessHost::SetApplicationPreloadState Method

This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Notifies ASP.NET that a particular application that is running on IIS 7.0 is configured to be preloaded.

Namespace:  System.Web.Hosting
Assembly:  System.Web (in System.Web.dll)

public:
virtual void SetApplicationPreloadState(
	String^ context, 
	String^ appId, 
	bool enabled
) sealed

Parameters

context
Type: System::String
The application context.
appId
Type: System::String
The unique ID of the application.
enabled
Type: System::Boolean
true to indicate the application should be preloaded; otherwise, false.

Implements

IApplicationPreloadManager::SetApplicationPreloadState(String, String, Boolean)

ExceptionCondition
ArgumentException

The IApplicationPreloadUtil instance that contains information for preloading the application is nullptr or empty.

ArgumentException

appId is nullptr or empty.

ArgumentException

enabled is set to true and the process host was not previously passed an IApplicationPreloadUtil interface to its SetApplicationPreloadUtil method

This method implements the SetApplicationPreloadState method of the IApplicationPreloadManager interface. IIS 7.0 calls the SetApplicationPreloadState method to notify ASP.NET whether the application that is being loaded supports preloading.

NoteNote

This method applies only to applications that run on IIS 7.0.

.NET Framework

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: