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)
The VCConfiguration type exposes the following members.
| 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 | Infrastructure. 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 | Adds a property sheet to the collection of property sheets directly imported by a configuration. |
|
|
Build | Builds the current configuration. |
|
|
BuildAndCallback | Begins an asynchronous build of this configuration. |
|
|
BuildWithProperty | Begins an asynchronous build with a given property set to some value beyond what is defined in the project file. |
|
|
BuildWithPropertySheet | Used to set properties for builds. |
|
|
BuildWithPropertySheetPath | Specifies a property sheet search path. |
|
|
Clean | Invokes the Clean command for the current configuration. |
|
|
ClearToolProperty | Clears the tool property value. |
|
|
CopyTo | Copies the current configuration. |
|
|
Delete | Infrastructure. Microsoft Internal Use Only. |
|
|
Deploy | Deploys the project. |
|
|
Evaluate | Evaluates the value of a project model or environment macro. See Macros for Build Commands and Properties for more information about these macros. |
|
|
IsBuildActionSupported | Indicates whether a specified type of build applies to the currrent project configuration. |
|
|
MatchName | Matches a specified name to the name of a collection item. |
|
|
MovePropertySheet | 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 | 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 Modifying Project Settings.
