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("ABE753ED-6BC6-47C2-9741-631AB73C0FA9")> _
Public Interface VCConfiguration
[GuidAttribute("ABE753ED-6BC6-47C2-9741-631AB73C0FA9")]
public interface VCConfiguration
[GuidAttribute(L"ABE753ED-6BC6-47C2-9741-631AB73C0FA9")]
public interface class VCConfiguration
[<GuidAttribute("ABE753ED-6BC6-47C2-9741-631AB73C0FA9")>]
type VCConfiguration = interface end
public interface VCConfiguration
The VCConfiguration type exposes the following members.
Properties
| Name | Description | |
|---|---|---|
.gif "Public property") |
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 | |
|---|---|---|
.gif "Public method") |
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. |
|
GetEvaluatedPropertyValue | |
|
GetUnevaluatedPropertyValue | |
|
GetVCService | |
|
IsBuildActionSupported | Indicates whether a specified type of build applies to the currrent project configuration. |
|
IsUpToDate | |
|
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 Working with Project Properties.