BuildContributorContext Class

SQL Server 2014

SQL Server 2012

Updated: April 20, 2017

Provides the context for the build process that is used by BuildContributor objects during project build. See documentation for the Arguments and ExtensionFiles properties for information on how to specify these inside a project file.

Namespace: Microsoft.SqlServer.Dac.Deployment
Assembly: Microsoft.SqlServer.Dac.Extensions (in Microsoft.SqlServer.Dac.Extensions.dll)

Inheritance Hierarchy

System::Object
Microsoft.SqlServer.Dac.Deployment::BuildContributorContext

Syntax

C++

public ref class BuildContributorContext sealed

Constructors

	Name	Description
	BuildContributorContext(Dictionary<String^, Object^>^, Dictionary<String^, String^>^, TSqlModel^, array<ITaskItem^>^)	Initializes a new instance of the BuildContributorContext class.

Properties

	Name	Description
	Arguments	Gets a dictionary of command-line arguments and their values. When building in SSDT, arguments are available when found in a .sqlproj file or a referenced .targets file. For instance to add a "RunMyContributor" argument with a value of "true", the following would be added: &lt;PropertyGroup&gt; &lt;ContributorArguments Condition="'$(Configuration)' == 'Debug''"&gt; $(ContributorArguments);RunMyContributor=True; &lt;/ContributorArguments&gt; &lt;/PropertyGroup&gt; In this case the argument is only added for Debug configuration. Using the above configuration it is possible to collect information from the MSBuild environment and pass it to the contributor.
	BuildProperties	Gets a dictionary of named properties and their values
	ExtensionFiles	Gets an array of Microsoft.Build.Framework.ITaskItem representing Files from the project system which influence the build contributors. Input configuration files can be defined in a .sqlproj file as part of the MSBuild process. Inside a .sqproj file, Build Configuration files are specified as follows: &lt;ItemGroup&gt; &lt;BuildExtensionConfiguration Include="MyContributorName.MyFileName1.sql" /&gt; &lt;BuildExtensionConfiguration Include="MyContributorName.MyFileName2.sql" /&gt; &lt;/ItemGroup&gt; Note that configuration files are accessible to all contributors. Contributors may employ a file naming pattern to identify which input files related to that contributor.
	Model	Gets the TSqlModel of the project