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)

Syntax

'Declaration
<GuidAttribute("0168EA0D-6DB0-457E-BDDD-27FD7A3EDFBB")> _
Public Interface VCConfiguration

[GuidAttribute("0168EA0D-6DB0-457E-BDDD-27FD7A3EDFBB")]
public interface VCConfiguration

[GuidAttribute(L"0168EA0D-6DB0-457E-BDDD-27FD7A3EDFBB")]
public interface class VCConfiguration

[<GuidAttribute("0168EA0D-6DB0-457E-BDDD-27FD7A3EDFBB")>]
type VCConfiguration =  interface end

public interface VCConfiguration

The VCConfiguration type exposes the following members.

Properties

	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.

Top

Methods

	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.

Top

Remarks

For more information, see Modifying Project Settings.

See Also

Reference

Microsoft.VisualStudio.VCProjectEngine Namespace