VCCLCompilerTool.PrecompiledHeaderThrough Property

Gets or sets the header file name to use when creating or using a precompiled header file. PrecompiledHeaderThrough exposes the functionality of the compiler's /Yc (Create Precompiled Header File), and /Yu (Use Precompiled Header File) options.

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

Syntax

Property PrecompiledHeaderThrough As String

Dim instance As VCCLCompilerTool
Dim value As String

value = instance.PrecompiledHeaderThrough

instance.PrecompiledHeaderThrough = value
string PrecompiledHeaderThrough { get; set; }
property String^ PrecompiledHeaderThrough {
    String^ get ();
    void set (String^ value);
}
function get PrecompiledHeaderThrough () : String
function set PrecompiledHeaderThrough (value : String)

Property Value

Type: System.String

The header file name to use when creating or using a precompiled header file.

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 PrecompiledHeaderThrough property in the integrated development environment (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 VCCLCompilerTool
        prj = DTE.Solution.Projects.Item(1).Object
        cfgs = prj.Configurations
        cfg = cfgs.Item(1)
        tool = cfg.Tools("VCCLCompilerTool")
        tool.PrecompiledHeaderThrough = "MyFile.h"
    End Sub
End Module

Permissions

See Also

Reference

VCCLCompilerTool Interface

VCCLCompilerTool Members

Microsoft.VisualStudio.VCProjectEngine Namespace