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.

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

[GuidAttribute("ABE753ED-6BC6-47C2-9741-631AB73C0FA9")]
public interface VCConfiguration

NameDescription
System_CAPS_pubpropertyATLMinimizesCRunTimeLibraryUsage

Causes ATL to link to the C runtime libraries statically to minimize dependencies; requires that useOfATL property is set.

System_CAPS_pubpropertyBuildLogFile

Sets or gets the name of the html log file.

System_CAPS_pubpropertyCharacterSet

Gets or sets a value that tells the compiler to use the specified character set.

System_CAPS_pubpropertyConfigurationName

Gets or sets the project configuration to be built.

System_CAPS_pubpropertyConfigurationType

Gets or sets the type of output this configuration generates.

System_CAPS_pubpropertyDebugSettings

Gets a pointer to the object containing the debug settings information for the selected configuration.

System_CAPS_pubpropertyDeleteExtensionsOnClean

Gets or sets which files in the intermediate directory to delete on clean or rebuild.

System_CAPS_pubpropertyDeploymentTool

Gets the deployment tool.

System_CAPS_pubpropertyDEPRECATED1

This API supports the product infrastructure and is not intended to be used directly from your code. Microsoft Internal Use Only.

System_CAPS_pubpropertyEnableManagedIncrementalBuild

Deprecated.

System_CAPS_pubpropertyExcludeBuckets

Sets or gets which tool buckets to ignore during a build.

System_CAPS_pubpropertyFileTools

Lists the available tools that operate on files.

System_CAPS_pubpropertyImportLibrary

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.

System_CAPS_pubpropertyInheritedPropertySheets

Sets or gets the property sheets for a config.

System_CAPS_pubpropertyIntermediateDirectory

Gets or sets a relative path to the intermediate file directory; can include environment variables.

System_CAPS_pubpropertyIntrinsicPropertySheets

Microsoft internal use only. Do not use.

System_CAPS_pubpropertyManagedExtensions

Gets or sets a configuration that uses Visual C++. ManagedExtensions exposes the functionality of the C++ compiler's /clr (Common Language Runtime Compilation) option.

System_CAPS_pubpropertyName

Gets or sets the name of the object.

System_CAPS_pubpropertyOutputDirectory

Gets or sets the directory in which to place output. The default directory is the project directory.

System_CAPS_pubpropertyPerUserRedirection

Gets a value that indicates whether COM registration for the current configuration is per-user or per-computer.

System_CAPS_pubpropertyPlatform

Gets the platform for which this configuration is being built.

System_CAPS_pubpropertyPrimaryOutput

Gets the primary output from building this configuration.

System_CAPS_pubpropertyProgramDatabase

Gets the program database, if any, that the configuration generates.

System_CAPS_pubpropertyproject

Gets the VCProject associated with the VCConfiguration.

System_CAPS_pubpropertyPropertySheets

Gets all property sheets for the project.

System_CAPS_pubpropertyRegisterOutput

Gets a value indicating whether the configuration registers the primary output of this build.

System_CAPS_pubpropertyRules

Gets a collection of IVCRulePropertyStorage objects that can modify to project-level properties and default item metadata defined in this property sheet.

System_CAPS_pubpropertySatelliteDLLs

Gets a semicolon-delimited list of all satellite DLLs that this configuration generates.

System_CAPS_pubpropertySqlAssemblyOwner

Sets or gets the SQL assembly owner.

System_CAPS_pubpropertySqlDebugScript

Gets or sets the name of the SQL debug script.

System_CAPS_pubpropertySqlDeploySource

Sets or gets whether to include source files when deploying a SQL assembly.

System_CAPS_pubpropertySqlPermissionLevel

Gets or sets the SQL permission level for the project.

System_CAPS_pubpropertySqlPostDeployScript

Sets or gets the script for post SQL deploy activity.

System_CAPS_pubpropertySqlPreDeployScript

Sets or gets the script for per SQL deploy activity.

System_CAPS_pubpropertyTools

Gets the available tools for the configuration.

System_CAPS_pubpropertyUpToDate

Gets a value indicating whether the current configuration's build state is up to date.

System_CAPS_pubpropertyuseOfATL

Gets or sets a value indicating how ATL is used by the configuration.

System_CAPS_pubpropertyuseOfMfc

Gets or sets how MFC is used by the configuration.

System_CAPS_pubpropertyVCProjectEngine

Gets a pointer to the project engine.

System_CAPS_pubpropertyWholeProgramOptimization

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.

NameDescription
System_CAPS_pubmethodAddPropertySheet(String)

Adds a property sheet to the collection of property sheets directly imported by a configuration.

System_CAPS_pubmethodBuild()

Builds the current configuration.

System_CAPS_pubmethodBuildAndCallback(bldActionTypes, IVCBuildCompleteCallback)

Begins an asynchronous build of this configuration.

System_CAPS_pubmethodBuildWithProperty(bldActionTypes, String, String, IVCBuildCompleteCallback)

Begins an asynchronous build with a given property set to some value beyond what is defined in the project file.

System_CAPS_pubmethodBuildWithPropertySheet(VCPropertySheet, BuildWithPropertySheetType)

Used to set properties for builds.

System_CAPS_pubmethodBuildWithPropertySheetPath(String, BuildWithPropertySheetType)

Specifies a property sheet search path.

System_CAPS_pubmethodClean()

Invokes the Clean command for the current configuration.

System_CAPS_pubmethodClearToolProperty(Object, String)

Clears the tool property value.

System_CAPS_pubmethodCopyTo(Object)

Copies the current configuration.

System_CAPS_pubmethodDelete()

This API supports the product infrastructure and is not intended to be used directly from your code. Microsoft Internal Use Only.

System_CAPS_pubmethodDeploy()

Deploys the project.

System_CAPS_pubmethodEvaluate(String)

Evaluates the value of a project model or environment macro. See Macros for Build Commands and Properties for more information about these macros.

System_CAPS_pubmethodGetEvaluatedPropertyValue(String)

System_CAPS_pubmethodGetUnevaluatedPropertyValue(String)

System_CAPS_pubmethodGetVCService(Guid)

System_CAPS_pubmethodIsBuildActionSupported(bldActionTypes)

Indicates whether a specified type of build applies to the currrent project configuration.

System_CAPS_pubmethodIsUpToDate(Object)

System_CAPS_pubmethodMatchName(String, Boolean)

Matches a specified name to the name of a collection item.

System_CAPS_pubmethodMovePropertySheet(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.

System_CAPS_pubmethodRebuild()

Rebuilds the current configuration.

System_CAPS_pubmethodRelink()

Relink the project.

System_CAPS_pubmethodRemovePropertySheet(VCPropertySheet)

Removes a property sheet from the collection of property sheets directly imported by a configuration.

System_CAPS_pubmethodStopBuild()

Cancels the build currently in progress on the specified configuration.

System_CAPS_pubmethodWaitForBuild()

Suspends processing until build is complete.

For more information, see Working with Project Properties.

Return to top
Show: