DotNetCoreMSBuildSettings Class

Summary

Contains settings used by DotNetCoreMSBuildBuilder.
Namespace
Cake.Common.Tools.DotNetCore.MSBuild
Base Types
graph BT Type-->Base0["DotNetMSBuildSettings"] click Base0 "/api/Cake.Common.Tools.DotNet.MSBuild/DotNetMSBuildSettings" Base0-->Base1["DotNetSettings"] click Base1 "/api/Cake.Common.Tools.DotNet/DotNetSettings" Base1-->Base2["ToolSettings"] click Base2 "/api/Cake.Core.Tooling/ToolSettings" Base2-->Base3["object"] Type["DotNetCoreMSBuildSettings"] class Type type-node

Syntax

public sealed class DotNetCoreMSBuildSettings : DotNetMSBuildSettings

Properties

Name Value Summary
ArgumentCustomization Func<ProcessArgumentBuilder, ProcessArgumentBuilder>
Gets or sets the argument customization. Argument customization is a way that lets you add, replace or reuse arguments passed to a tool. This allows you to support new tool arguments, customize arguments or address potential argument issues.
Inherited from ToolSettings
AssemblyVersion string
Gets or sets the assembly version number embedded in the build output.
Inherited from DotNetMSBuildSettings
BinaryLogger MSBuildBinaryLoggerSettings
Gets or sets the binary logging options.
Inherited from DotNetMSBuildSettings
ConsoleLoggerSettings MSBuildLoggerSettings
Gets or sets the parameters for the console logger.
Inherited from DotNetMSBuildSettings
ContinuousIntegrationBuild bool?
Gets or sets a value indicating whether to normalize stored file paths used when producing deterministic builds.
Inherited from DotNetMSBuildSettings
DetailedSummary bool
Gets or sets a value indicating whether to show detailed information at the end of the build log about the configurations that were built and how they were scheduled to nodes.
Inherited from DotNetMSBuildSettings
DiagnosticOutput bool
Gets or sets a value indicating whether to not enable diagnostic output.
Inherited from DotNetSettings
DisableConsoleLogger bool
Gets or sets a value indicating whether to disable the default console logger, and not log events to the console.
Inherited from DotNetMSBuildSettings
DistributedFileLogger bool
Gets or sets a value indicating whether to log the build output of each MSBuild node to its own file.
Inherited from DotNetMSBuildSettings
DistributedLoggers ICollection<MSBuildDistributedLogger>
Gets the distributed loggers to use.
Inherited from DotNetMSBuildSettings
EnvironmentVariables IDictionary<string, string>
Gets or sets search paths for files, directories for temporary files, application-specific options, and other similar information.
Inherited from ToolSettings
ExcludeAutoResponseFiles bool
Gets or sets a value indicating whether to exclude any MSBuild.rsp files automatically.
Inherited from DotNetMSBuildSettings
FileLoggers ICollection<MSBuildFileLoggerSettings>
Gets the file loggers to use.
Inherited from DotNetMSBuildSettings
FileVersion string
Gets or sets the file version number embedded in the build output.
Inherited from DotNetMSBuildSettings
HandleExitCode Func<int, bool>
Gets or sets whether the exit code from the tool process causes an exception to be thrown.

If the delegate is null (the default) or returns false, then an exception is thrown upon a non-zero exit code.

If the delegate returns true then no exception is thrown.

This can be useful when the exit code should be ignored, or if there is a desire to apply logic that is conditional on the exit code value.

Inherited from ToolSettings
IgnoreProjectExtensions ICollection<string>
Gets or sets extensions to ignore when determining which project file to build.
Inherited from DotNetMSBuildSettings
InformationalVersion string
Gets or sets the assembly informational version number embedded in the build output.
Inherited from DotNetMSBuildSettings
Loggers ICollection<MSBuildLogger>
Gets the loggers to use to log events from MSBuild.
Inherited from DotNetMSBuildSettings
MaxCpuCount int?
Gets or sets the maximum number of concurrent processes to use when building.
Inherited from DotNetMSBuildSettings
NoLogo bool
Gets or sets a value indicating whether to display the startup banner and the copyright message.
Inherited from DotNetMSBuildSettings
NoWorkingDirectory bool
Gets or sets a value indicating whether or not to opt out of using an explicit working directory for the process.
Inherited from ToolSettings
PackageReleaseNotes string
Gets or sets the release notes of the NuGet package generated.
Inherited from DotNetMSBuildSettings
PackageVersion string
Gets or sets the version number of the NuGet package generated.
Inherited from DotNetMSBuildSettings
PostAction Action<IProcess>
Gets or sets a delegate which is executed after the process was started.
Inherited from ToolSettings
Properties IDictionary<string, ICollection<string>>
Gets the project-level properties to set or override.
Inherited from DotNetMSBuildSettings
ResponseFiles ICollection<FilePath>
Gets the response files to use.
Inherited from DotNetMSBuildSettings
RollForward DotNetRollForward?
Gets or sets the dotnet roll forward policy.
Inherited from DotNetSettings
SetupProcessSettings Action<ProcessSettings>
Gets or sets a delegate to configure the process settings.
Inherited from ToolSettings
Targets ICollection<string>
Gets the targets to build in the project.
Inherited from DotNetMSBuildSettings
ToolPath FilePath
Gets or sets the tool path.
Inherited from ToolSettings
ToolTimeout TimeSpan?
Gets or sets optional timeout for tool execution.
Inherited from ToolSettings
ToolVersion MSBuildVersion?
Gets or sets the version of the Toolset to use to build the project.
Inherited from DotNetMSBuildSettings
TreatAllWarningsAs MSBuildTreatAllWarningsAs
Gets or sets a value indicating how all warnings should be treated.
Inherited from DotNetMSBuildSettings
ValidateProjectFile bool
Gets or sets a value indicating whether to validate the project file and, if validation succeeds, build the project.
Inherited from DotNetMSBuildSettings
Verbosity DotNetVerbosity?
Gets or sets the verbosity of logging to use.
Inherited from DotNetSettings
Version string
Gets or sets the default value of all the version numbers embedded in the build output.
Inherited from DotNetMSBuildSettings
VersionPrefix string
Gets or sets the base version number embedded in the build output.
Inherited from DotNetMSBuildSettings
VersionSuffix string
Gets or sets the pre-release label of the version number embedded in the build output.
Inherited from DotNetMSBuildSettings
WarningCodesAsError IList<string>
Gets the warning codes to treats as errors.
Inherited from DotNetMSBuildSettings
WarningCodesAsMessage IList<string>
Gets the warning codes to treats as low importance messages.
Inherited from DotNetMSBuildSettings
WorkingDirectory DirectoryPath
Gets or sets the working directory for the tool process.
Inherited from ToolSettings

Extension Methods

Name Value Summary
AddFileLogger() DotNetCoreMSBuildSettings
Adds a file logger with all the default settings.
AddFileLogger(MSBuildFileLoggerSettings) DotNetCoreMSBuildSettings
Adds a file logger.
AddFileLogger() DotNetMSBuildSettings
Adds a file logger with all the default settings.
AddFileLogger(MSBuildFileLoggerSettings) DotNetMSBuildSettings
Adds a file logger.
DisableConsoleLogger() DotNetCoreMSBuildSettings
Disables the default console logger, and not log events to the console.
DisableConsoleLogger() DotNetMSBuildSettings
Disables the default console logger, and not log events to the console.
Dump<DotNetCoreMSBuildSettings>() string
Get a basic string representation of specified object.
Requires the Cake.Incubator addin
EnableBinaryLogger() DotNetCoreMSBuildSettings
Enables the binary logger with all the default settings.
EnableBinaryLogger(MSBuildBinaryLoggerImports) DotNetCoreMSBuildSettings
Enables the binary logger with the specified imports and default file name.
EnableBinaryLogger(string) DotNetCoreMSBuildSettings
Enables the binary logger with the specified log file name and no imports.
EnableBinaryLogger(string, MSBuildBinaryLoggerImports) DotNetCoreMSBuildSettings
Enables the binary logger with the specified log file name and imports.
EnableBinaryLogger() DotNetMSBuildSettings
Enables the binary logger with all the default settings.
EnableBinaryLogger(MSBuildBinaryLoggerImports) DotNetMSBuildSettings
Enables the binary logger with the specified imports and default file name.
EnableBinaryLogger(string) DotNetMSBuildSettings
Enables the binary logger with the specified log file name and no imports.
EnableBinaryLogger(string, MSBuildBinaryLoggerImports) DotNetMSBuildSettings
Enables the binary logger with the specified log file name and imports.
ExcludeAutoResponseFiles() DotNetCoreMSBuildSettings
Exclude any MSBuild.rsp files automatically.
ExcludeAutoResponseFiles() DotNetMSBuildSettings
Exclude any MSBuild.rsp files automatically.
HideLogo() DotNetCoreMSBuildSettings
Hide the startup banner and the copyright message.
HideLogo() DotNetMSBuildSettings
Hide the startup banner and the copyright message.
IsIn<DotNetCoreMSBuildSettings>(DotNetCoreMSBuildSettings[]) bool
Checks if the source is contained in a list
Requires the Cake.Incubator addin
NotNull<DotNetCoreMSBuildSettings>(string) void
Throws an exception if the specified parameter's value is null.
Requires the Cake.Issues addin
NotNull<DotNetCoreMSBuildSettings>(string) void
Throws an exception if the specified parameter's value is null.
Requires the Cake.Ftp addin
SetAssemblyVersion(string) DotNetCoreMSBuildSettings
Sets the assembly version.
SetAssemblyVersion(string) DotNetMSBuildSettings
Sets the assembly version.
SetConfiguration(string) DotNetCoreMSBuildSettings
Sets the configuration.
SetConfiguration(string) DotNetMSBuildSettings
Sets the configuration.
SetConsoleLoggerSettings(MSBuildLoggerSettings) DotNetCoreMSBuildSettings
Sets the parameters for the console logger.
SetConsoleLoggerSettings(MSBuildLoggerSettings) DotNetMSBuildSettings
Sets the parameters for the console logger.
SetContinuousIntegrationBuild(bool?) DotNetCoreMSBuildSettings
Sets a value indicating whether to normalize stored file paths used when producing deterministic builds.
SetContinuousIntegrationBuild(bool?) DotNetMSBuildSettings
Sets a value indicating whether to normalize stored file paths used when producing deterministic builds.
SetFileVersion(string) DotNetCoreMSBuildSettings
Sets the file version.
SetFileVersion(string) DotNetMSBuildSettings
Sets the file version.
SetInformationalVersion(string) DotNetCoreMSBuildSettings
Sets the informational version.
SetInformationalVersion(string) DotNetMSBuildSettings
Sets the informational version.
SetMaxCpuCount(int?) DotNetCoreMSBuildSettings
Sets the maximum CPU count. Without this set MSBuild will compile projects in this solution one at a time.
SetMaxCpuCount(int?) DotNetMSBuildSettings
Sets the maximum CPU count. Without this set MSBuild will compile projects in this solution one at a time.
SetPackageReleaseNotes(string) DotNetCoreMSBuildSettings
Sets the package release notes.
SetPackageReleaseNotes(string) DotNetMSBuildSettings
Sets the package release notes.
SetPackageVersion(string) DotNetCoreMSBuildSettings
Sets the package version.
SetPackageVersion(string) DotNetMSBuildSettings
Sets the package version.
SetRuntime(string) DotNetCoreMSBuildSettings
Sets a target operating systems where the application or assembly will run.
SetRuntime(string) DotNetMSBuildSettings
Sets a target operating systems where the application or assembly will run.
SetTargetFramework(string) DotNetCoreMSBuildSettings
Adds a framework to target.
SetTargetFramework(string) DotNetMSBuildSettings
Adds a framework to target.
SetVersion(string) DotNetCoreMSBuildSettings
Sets the version.
SetVersion(string) DotNetMSBuildSettings
Sets the version.
SetVersionPrefix(string) DotNetCoreMSBuildSettings
Sets the version prefix.
SetVersionPrefix(string) DotNetMSBuildSettings
Sets the version prefix.
SetVersionSuffix(string) DotNetCoreMSBuildSettings
Sets the version Suffix.
SetVersionSuffix(string) DotNetMSBuildSettings
Sets the version Suffix.
SetWarningCodeAsError(string) DotNetCoreMSBuildSettings
Sets the warning code to treats as an error.
SetWarningCodeAsError(string) DotNetMSBuildSettings
Sets the warning code to treats as an error.
SetWarningCodeAsMessage(string) DotNetCoreMSBuildSettings
Sets the warning code to treats as a message.
SetWarningCodeAsMessage(string) DotNetMSBuildSettings
Sets the warning code to treats as a message.
ShowDetailedSummary() DotNetCoreMSBuildSettings
Shows detailed information at the end of the build log about the configurations that were built and how they were scheduled to nodes.
ShowDetailedSummary() DotNetMSBuildSettings
Shows detailed information at the end of the build log about the configurations that were built and how they were scheduled to nodes.
SuppressVersionRecommendedFormatWarning() DotNetCoreMSBuildSettings
Suppress warning CS7035. This is useful when using semantic versioning and either the file or informational version doesn't match the recommended format. The recommended format is: major.minor.build.revision where each is an integer between 0 and 65534 (inclusive).
SuppressVersionRecommendedFormatWarning() DotNetMSBuildSettings
Suppress warning CS7035. This is useful when using semantic versioning and either the file or informational version doesn't match the recommended format. The recommended format is: major.minor.build.revision where each is an integer between 0 and 65534 (inclusive).
ThrowIfNull<DotNetCoreMSBuildSettings>(string) T
Throws a System.ArgumentNullException if the value is null, otherwise returns the value
Requires the Cake.Incubator addin
ThrowIfNull<DotNetCoreMSBuildSettings>(string, string) T
Throws a System.ArgumentNullException with a specific message if the value is null, otherwise returns the value
Requires the Cake.Incubator addin
ToDictionary() IDictionary<string, object>
Requires the Cake.DeployParams addin
TreatAllWarningsAs(MSBuildTreatAllWarningsAs) DotNetCoreMSBuildSettings
Sets how all warnings should be treated.
TreatAllWarningsAs(MSBuildTreatAllWarningsAs) DotNetMSBuildSettings
Sets how all warnings should be treated.
UseDistributedFileLogger() DotNetCoreMSBuildSettings
Log the build output of each MSBuild node to its own file.
UseDistributedFileLogger() DotNetMSBuildSettings
Log the build output of each MSBuild node to its own file.
UseToolVersion(MSBuildVersion) DotNetCoreMSBuildSettings
Sets the version of the Toolset to use to build the project.
UseToolVersion(MSBuildVersion) DotNetMSBuildSettings
Sets the version of the Toolset to use to build the project.
ValidateProjectFile() DotNetCoreMSBuildSettings
Validate the project file and, if validation succeeds, build the project.
ValidateProjectFile() DotNetMSBuildSettings
Validate the project file and, if validation succeeds, build the project.
WithDistributedLogger(MSBuildDistributedLogger) DotNetCoreMSBuildSettings
Adds a distributed loggers to use.
WithDistributedLogger(MSBuildDistributedLogger) DotNetMSBuildSettings
Adds a distributed loggers to use.
WithIgnoredProjectExtension(string) DotNetCoreMSBuildSettings
Adds a extension to ignore when determining which project file to build.
WithIgnoredProjectExtension(string) DotNetMSBuildSettings
Adds a extension to ignore when determining which project file to build.
WithLogger(string, string, string) DotNetCoreMSBuildSettings
Adds a custom logger.
WithLogger(string, string, string) DotNetMSBuildSettings
Adds a custom logger.
WithProperty(string, string[]) DotNetCoreMSBuildSettings
Adds a property to the configuration.
WithProperty(string, string[]) DotNetMSBuildSettings
Adds a property to the configuration.
WithResponseFile(FilePath) DotNetCoreMSBuildSettings
Adds a response file to use.
WithResponseFile(FilePath) DotNetMSBuildSettings
Adds a response file to use.
WithTarget(string) DotNetCoreMSBuildSettings
Adds a MSBuild target to the configuration.
WithTarget(string) DotNetMSBuildSettings
Adds a MSBuild target to the configuration.