VCConfiguration Members

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.

The VCConfiguration type exposes the following members.

Methods

	Name	Description
	Build	Builds the current configuration.
	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.
	MatchName	Matches a specified name to the name of a collection item.
	Rebuild	Rebuilds the current configuration.
	Relink	Relink the project.
	StopBuild	Cancels the build currently in progress on the specified configuration.
	WaitForBuild	Suspends processing until build is complete.

Top

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

See Also

Reference

VCConfiguration Interface

Microsoft.VisualStudio.VCProjectEngine Namespace