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)

property bool UnloadBeforeCopy {
	bool get();
	void set(bool value);
}

Property Value

Type: System::Boolean

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

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.

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
Return to top
Show: