VCConfiguration Members

Include Protected Members
Include Inherited 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

Public method

Build

Builds the current configuration.

Public method

BuildWithPropertySheet

Used to set properties for builds.

Public method

BuildWithPropertySheetPath

Specifies a property sheet search path.

Public method

Clean

Invokes the Clean command for the current configuration.

Public method

ClearToolProperty

Clears the tool property value.

Public method

CopyTo

Copies the current configuration.

Public method

Delete

Infrastructure. Microsoft Internal Use Only.

Public method

Deploy

Deploys the project.

Public method

Evaluate

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

Public method

MatchName

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

Public method

Rebuild

Rebuilds the current configuration.

Public method

Relink

Relink the project.

Public method

StopBuild

Cancels the build currently in progress on the specified configuration.

Public method

WaitForBuild

Suspends processing until build is complete.

Top

Properties

 

Name

Description

Public property

ATLMinimizesCRunTimeLibraryUsage

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

Public property

BuildLogFile

Sets or gets the name of the html log file.

Public property

CharacterSet

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

Public property

ConfigurationName

Gets or sets the project configuration to be built.

Public property

ConfigurationType

Gets or sets the type of output this configuration generates.

Public property

DebugSettings

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

Public property

DeleteExtensionsOnClean

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

Public property

DeploymentTool

Gets the deployment tool.

Public property

DEPRECATED1

Infrastructure. Microsoft Internal Use Only.

Public property

ExcludeBuckets

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

Public property

FileTools

Lists the available tools that operate on files.

Public property

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.

Public property

InheritedPropertySheets

Sets or gets the property sheets for a config.

Public property

IntermediateDirectory

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

Public property

IntrinsicPropertySheets

Microsoft internal use only. Do not use.

Public property

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.

Public property

Name

Gets or sets the name of the object.

Public property

OutputDirectory

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

Public property

Platform

Gets the platform for which this configuration is being built.

Public property

PrimaryOutput

Gets the primary output from building this configuration.

Public property

ProgramDatabase

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

Public property

project

Gets the VCProject associated with the VCConfiguration.

Public property

PropertySheets

Gets all property sheets for the project.

Public property

RegisterOutput

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

Public property

SatelliteDLLs

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

Public property

SqlAssemblyOwner

Sets or gets the SQL assembly owner.

Public property

SqlDebugScript

Gets or sets the name of the SQL debug script.

Public property

SqlDeploySource

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

Public property

SqlPermissionLevel

Gets or sets the SQL permission level for the project.

Public property

SqlPostDeployScript

Sets or gets the script for post SQL deploy activity.

Public property

SqlPreDeployScript

Sets or gets the script for per SQL deploy activity.

Public property

Tools

Gets the available tools for the configuration.

Public property

UpToDate

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

Public property

useOfATL

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

Public property

useOfMfc

Gets or sets how MFC is used by the configuration.

Public property

VCProjectEngine

Gets a pointer to the project engine.

Public property

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