VCConfiguration Interface
The VCConfiguration object programmatically accesses the properties in the General property page of a project's Property Pages dialog box. This object also allows access to the tools used to build this configuration.
Assembly: Microsoft.VisualStudio.VCProjectEngine (in Microsoft.VisualStudio.VCProjectEngine.dll)
| Name | Description | |
|---|---|---|
![]() | ATLMinimizesCRunTimeLibraryUsage | Causes ATL to link to the C runtime libraries statically to minimize dependencies; requires that useOfATL property is set. |
![]() | BuildLogFile | Sets or gets the name of the html log file. |
![]() | CharacterSet | Gets or sets a value that tells the compiler to use the specified character set. |
![]() | ConfigurationName | Gets or sets the project configuration to be built. |
![]() | ConfigurationType | Gets or sets the type of output this configuration generates. |
![]() | DebugSettings | Gets a pointer to the object containing the debug settings information for the selected configuration. |
![]() | DeleteExtensionsOnClean | Gets or sets which files in the intermediate directory to delete on clean or rebuild. |
![]() | DeploymentTool | Gets the deployment tool. |
![]() | DEPRECATED1 | This API supports the product infrastructure and is not intended to be used directly from your code. Microsoft Internal Use Only. |
![]() | EnableManagedIncrementalBuild | Deprecated. |
![]() | ExcludeBuckets | Sets or gets which tool buckets to ignore during a build. |
![]() | FileTools | Lists the available tools that operate on files. |
![]() | ImportLibrary | Gets which import library to generate or reports which import library will be generated by the configuration. ImportLibrary exposes the functionality of the /IMPLIB (Name Import Library) linker option. |
![]() | InheritedPropertySheets | Sets or gets the property sheets for a config. |
![]() | IntermediateDirectory | Gets or sets a relative path to the intermediate file directory; can include environment variables. |
![]() | IntrinsicPropertySheets | Microsoft internal use only. Do not use. |
![]() | ManagedExtensions | Gets or sets a configuration that uses Visual C++. ManagedExtensions exposes the functionality of the C++ compiler's /clr (Common Language Runtime Compilation) option. |
![]() | Name | Gets or sets the name of the object. |
![]() | OutputDirectory | Gets or sets the directory in which to place output. The default directory is the project directory. |
![]() | PerUserRedirection | Gets a value that indicates whether COM registration for the current configuration is per-user or per-computer. |
![]() | Platform | Gets the platform for which this configuration is being built. |
![]() | PrimaryOutput | Gets the primary output from building this configuration. |
![]() | ProgramDatabase | Gets the program database, if any, that the configuration generates. |
![]() | project | Gets the VCProject associated with the VCConfiguration. |
![]() | PropertySheets | Gets all property sheets for the project. |
![]() | RegisterOutput | Gets a value indicating whether the configuration registers the primary output of this build. |
![]() | Rules | Gets a collection of IVCRulePropertyStorage objects that can modify to project-level properties and default item metadata defined in this property sheet. |
![]() | SatelliteDLLs | Gets a semicolon-delimited list of all satellite DLLs that this configuration generates. |
![]() | SqlAssemblyOwner | Sets or gets the SQL assembly owner. |
![]() | SqlDebugScript | Gets or sets the name of the SQL debug script. |
![]() | SqlDeploySource | Sets or gets whether to include source files when deploying a SQL assembly. |
![]() | SqlPermissionLevel | Gets or sets the SQL permission level for the project. |
![]() | SqlPostDeployScript | Sets or gets the script for post SQL deploy activity. |
![]() | SqlPreDeployScript | Sets or gets the script for per SQL deploy activity. |
![]() | Tools | Gets the available tools for the configuration. |
![]() | UpToDate | Gets a value indicating whether the current configuration's build state is up to date. |
![]() | useOfATL | Gets or sets a value indicating how ATL is used by the configuration. |
![]() | useOfMfc | Gets or sets how MFC is used by the configuration. |
![]() | VCProjectEngine | Gets a pointer to the project engine. |
![]() | WholeProgramOptimization | Gets or sets cross-module optimizations by delaying code generation to link time. WholeProgramOptimization exposes the functionality of the compiler's /GL (Whole Program Optimization) option. |
| Name | Description | |
|---|---|---|
![]() | AddPropertySheet(String) | Adds a property sheet to the collection of property sheets directly imported by a configuration. |
![]() | Build() | Builds the current configuration. |
![]() | BuildAndCallback(bldActionTypes, IVCBuildCompleteCallback) | Begins an asynchronous build of this configuration. |
![]() | BuildWithProperty(bldActionTypes, String, String, IVCBuildCompleteCallback) | Begins an asynchronous build with a given property set to some value beyond what is defined in the project file. |
![]() | BuildWithPropertySheet(VCPropertySheet, BuildWithPropertySheetType) | Used to set properties for builds. |
![]() | BuildWithPropertySheetPath(String, BuildWithPropertySheetType) | Specifies a property sheet search path. |
![]() | Clean() | Invokes the Clean command for the current configuration. |
![]() | ClearToolProperty(Object, String) | Clears the tool property value. |
![]() | CopyTo(Object) | Copies the current configuration. |
![]() | Delete() | This API supports the product infrastructure and is not intended to be used directly from your code. Microsoft Internal Use Only. |
![]() | Deploy() | Deploys the project. |
![]() | Evaluate(String) | Evaluates the value of a project model or environment macro. See Macros for Build Commands and Properties for more information about these macros. |
![]() | GetEvaluatedPropertyValue(String) | |
![]() | GetUnevaluatedPropertyValue(String) | |
![]() | GetVCService(Guid) | |
![]() | IsBuildActionSupported(bldActionTypes) | Indicates whether a specified type of build applies to the currrent project configuration. |
![]() | IsUpToDate(Object) | |
![]() | MatchName(String, Boolean) | Matches a specified name to the name of a collection item. |
![]() | MovePropertySheet(VCPropertySheet, Boolean) | Moves a property sheet one position before or after the other property sheets directly imported by this configuration. Position is based on the evaluation order of the property sheets. |
![]() | Rebuild() | Rebuilds the current configuration. |
![]() | Relink() | Relink the project. |
![]() | RemovePropertySheet(VCPropertySheet) | Removes a property sheet from the collection of property sheets directly imported by a configuration. |
![]() | StopBuild() | Cancels the build currently in progress on the specified configuration. |
![]() | WaitForBuild() | Suspends processing until build is complete. |
For more information, see Working with Project Properties.

