VCPreBuildEventTool.ExcludedFromBuild Property

Reference

Definition

Namespace:: Microsoft.VisualStudio.VCProjectEngine

Assembly:: Microsoft.VisualStudio.VCProjectEngine.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets a value indicating whether this item is excluded from the build.

public:
 property bool ExcludedFromBuild { bool get(); void set(bool value); };

public:
 property bool ExcludedFromBuild { bool get(); void set(bool value); };

[System.Runtime.InteropServices.DispId(3)]
public bool ExcludedFromBuild { [System.Runtime.InteropServices.DispId(3)] get; [System.Runtime.InteropServices.DispId(3)] set; }

[<System.Runtime.InteropServices.DispId(3)>]
[<get: System.Runtime.InteropServices.DispId(3)>]
[<set: System.Runtime.InteropServices.DispId(3)>]
member this.ExcludedFromBuild : bool with get, set

Public Property ExcludedFromBuild As Boolean

Property Value

Boolean

true if this item is excluded from the build; otherwise, false.

Attributes: DispIdAttribute

Examples

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

The following example modifies the VCPreLinkEventTool object's ExcludedFromBuild property in the IDE:

' add reference to Microsoft.VisualStudio.VCProjectEngine  
Imports EnvDTE  
Imports Microsoft.VisualStudio.VCProjectEngine  

Public Module Module1  
    Sub Test()  
        Dim prj As VCProject  
        Dim cfgs, tools As IVCCollection  
        Dim cfg As VCConfiguration  
        Dim tool As VCPostBuildEventTool  
        prj = DTE.Solution.Projects.Item(1).Object  
        cfgs = prj.Configurations  
        cfg = cfgs.Item(1)  
        tool = cfg.Tools("VCPreLinkEventTool")  
        tool.ExcludedFromBuild = False  
    End Sub  
End Module

Remarks

See the General Property Page (File) for information about accessing ExcludedFromBuild for a file from the integrated development environment (IDE).

See Specifying Build Events for information about accessing ExcludedFromBuild for a build event from the IDE.

ExcludedFromBuild specifies whether or not deployment occurs when the project is built. Set to true to disable deployment or set to false to enable deployment.

Applies to