VCWebDeploymentTool.UnloadBeforeCopy Property

Gets 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.

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

Syntax

'Declaration
Property UnloadBeforeCopy As Boolean
bool UnloadBeforeCopy { get; set; }
property bool UnloadBeforeCopy {
    bool get ();
    void set (bool value);
}
abstract UnloadBeforeCopy : bool with get, set
function get UnloadBeforeCopy () : boolean 
function set UnloadBeforeCopy (value : boolean)

Property Value

Type: System.Boolean
true to unload ISAPI extension or extensions associated with the virtual directory before deploying; otherwise, false.

Remarks

If this property is set to true and the ISAPI extension is running in the IIS process, the WWW publishing service is reset. Otherwise, only the virtual directory that the VirtualDirectoryName property specifies is affected.

Examples

See How to: Compile Example Code for Project Model Extensibility for information about how to compile and run this example.

The following example uses the UnloadBeforeCopy property in the integrated development environment (IDE):

' add reference to Microsoft.VisualStudio.VCProjectEngine
Imports EnvDTE

Imports Microsoft.VisualStudio.VCProjectEngine

Public Module Module1
   Sub Main()
      Dim prj As VCProject
      Dim cfgs, tools As IVCCollection
      Dim cfg As VCConfiguration
      Dim wdt As VCWebDeploymentTool
      prj = DTE.Solution.Projects.Item(1).Object
      cfgs = prj.Configurations
      cfg = cfgs.Item(1)
      wdt = cfg.Tools("VCWebDeploymentTool")
      wdt.UnloadBeforeCopy = True
   End Sub
End Module

.NET Framework Security

See Also

Reference

VCWebDeploymentTool Interface

Microsoft.VisualStudio.VCProjectEngine Namespace