Dela via


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
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 EnableManagedIncrementalBuild Deprecated.
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 PerUserRedirection Gets a value that indicates whether COM registration for the current configuration is per-user or per-computer.
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 Rules Gets a collection of IVCRulePropertyStorage objects that can modify to project-level properties and default item metadata defined in this property sheet.
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

Methods

  Name Description
Public method AddPropertySheet Adds a property sheet to the collection of property sheets directly imported by a configuration.
Public method Build Builds the current configuration.
Public method BuildAndCallback Begins an asynchronous build of this configuration.
Public method BuildWithProperty Begins an asynchronous build with a given property set to some value beyond what is defined in the project file.
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 IsBuildActionSupported Indicates whether a specified type of build applies to the currrent project configuration.
Public method MatchName Matches a specified name to the name of a collection item.
Public method 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.
Public method Rebuild Rebuilds the current configuration.
Public method Relink Relink the project.
Public method RemovePropertySheet Removes a property sheet from the collection of property sheets directly imported by a configuration.
Public method StopBuild Cancels the build currently in progress on the specified configuration.
Public method WaitForBuild Suspends processing until build is complete.

Top

Remarks

For more information, see Modifying Project Settings.

See Also

Reference

Microsoft.VisualStudio.VCProjectEngine Namespace