We recommend using Visual Studio 2017
This documentation is archived and is not being maintained.

VCWebDeploymentTool Interface

The VCWebDeploymentTool object provides programmatic access to the Web deployment tool.

Namespace:  Microsoft.VisualStudio.VCProjectEngine
Assembly:  Microsoft.VisualStudio.VCProjectEngine (in Microsoft.VisualStudio.VCProjectEngine.dll)

public interface VCWebDeploymentTool

The VCWebDeploymentTool type exposes the following members.

Public propertyAdditionalFilesGets or sets the semicolon-separated list of additional files to be deployed.
Public propertyApplicationMappingsGets or sets the semicolon-separated list of file extensions to be associated with the primary project output.
Public propertyApplicationProtectionThe level of process isolation used by the virtual directory.
Public propertyExcludedFromBuildGets or sets a value indicating whether this item is excluded from the build.
Public propertyExecutionBucketInfrastructure. Microsoft Internal Use Only.
Public propertyRegisterOutputGets or sets a value indicating whether the primary project output should be registered using Regsvr32 after deployment.
Public propertyRelativePathGets or sets the path that is relative to the virtual directory and to which the primary project output is copied when deployment occurs.
Public propertyToolKindGets the name of the kind of tool this is.
Public propertytoolNameGets the name of the specified tool.
Public propertyToolPathGets the path to the specified tool.
Public propertyUnloadBeforeCopyGets or sets a value indicating whether or not to unload the Internet Server Application Programming Interface (ISAPI) extension or extensions associated with the virtual directory before deploying.
Public propertyVCProjectEngineGets a pointer to the project engine.
Public propertyVirtualDirectoryNameGets or sets the alias of the virtual directory.

Public methodget_PropertyOptionInfrastructure. Microsoft Internal Use Only.

The VCWebDeploymentTool is used to install files produced by your project so that they are served by Internet Information Services. Enabling Web deployment frees you from having to create virtual directories, configure application mappings, and copy content during development of your applications.

See the documentation for the Deployment (How Do I in Visual Web Developer) for information about the user interface that corresponds to the properties provided by this object.


Web deployment can only be performed by a user who is a member of the Administrators group on the local machine. Web deployment can only deploy to the first Web site on the local machine.


Deployment of ATL Server projects to IIS is not supported on a Web server running on a 64-bit platform.

Web deployment is a build step that occurs only if the link step occurs. See Understanding Custom Build Steps and Build Events to see when this build step is executed in relation to the other steps.