Export (0) Print
Expand All

Csc Class

This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Implements the Csc task. Use the Csc element in your project file to create and execute this task. For usage and parameter information, see Csc Task.

Namespace:  Microsoft.Build.Tasks
Assembly:  Microsoft.Build.Tasks.v4.0 (in Microsoft.Build.Tasks.v4.0.dll)

public class Csc : ManagedCompiler

The Csc type exposes the following members.

  NameDescription
Public methodCscInfrastructure. Initializes a new instance of the Csc class.
Top

  NameDescription
Public propertyAdditionalLibPathsInfrastructure. Gets or sets the additional folders in which to look for assemblies. (Inherited from ManagedCompiler.)
Public propertyAddModulesInfrastructure. Gets or sets the modules for the compiler to make available to the project you are currently compiling. (Inherited from ManagedCompiler.)
Public propertyAllowUnsafeBlocksInfrastructure. Gets or sets a Boolean value that indicates whether to compile code that uses the unsafe keyword.
Public propertyApplicationConfigurationReturns configuration information.
Protected propertyBagInfrastructure. Gets the collection of parameters used by the derived task class. (Inherited from ToolTaskExtension.)
Public propertyBaseAddressInfrastructure. Gets or sets the preferred base address at which to load a DLL.
Public propertyBuildEngineGets or sets the instance of the IBuildEngine object used by the task. (Inherited from Task.)
Public propertyBuildEngine2Gets the instance of the IBuildEngine2 object used by the task. (Inherited from Task.)
Public propertyBuildEngine3Gets the instance of the IBuildEngine3 object used by the task. (Inherited from Task.)
Public propertyBuildEngine4Gets the instance of the IBuildEngine4 object used by the task. (Inherited from Task.)
Public propertyCheckForOverflowUnderflowInfrastructure. Gets or sets a Boolean value that indicates whether the Csc task should cause an exception at run time for integer arithmetic that overflows the bounds of the data type.
Public propertyCodePageInfrastructure. Gets or sets the code page to use for all source code files in the compilation. (Inherited from ManagedCompiler.)
Public propertyDebugTypeInfrastructure. Gets or sets the debug type. (Inherited from ManagedCompiler.)
Public propertyDefineConstantsInfrastructure. Gets or sets the conditional compiler constants. (Inherited from ManagedCompiler.)
Public propertyDelaySignInfrastructure. Gets or sets a value indicating whether the public key is placed in the assembly. (Inherited from ManagedCompiler.)
Public propertyDisabledWarningsInfrastructure. Gets or sets the list of warnings to be disabled.
Public propertyDocumentationFileInfrastructure. Gets or sets the XML file to hold the documentation comments.
Public propertyEchoOffIndicates that command line echoing is turned off. (Inherited from ToolTask.)
Public propertyEmitDebugInformationInfrastructure. Gets or sets a value indicating whether the compiler generates debugging information. (Inherited from ManagedCompiler.)
Protected propertyEnvironmentOverride Obsolete. Gets a set of environment variable name-value pairs. Designed to be overridden in a custom task class (derived from ToolTask) to return a set of new or altered environment variables to create the execution context of the associated tool. (Inherited from ToolTask.)
Public propertyEnvironmentVariablesArray of equals-separated pairs of environment variables that should be passed to the spawned executable, in addition to (or selectively overriding) the regular environment block. (Inherited from ToolTask.)
Public propertyErrorEndLocationIf true, outputs the line and column of the end location of each error.
Public propertyErrorReportInfrastructure. Gets or sets the method to report a C# internal compiler error to Microsoft.
Public propertyExitCodeGets the returned exit code of the executable file. (Inherited from ToolTask.)
Public propertyFileAlignmentInfrastructure. Gets or sets a value indicating where to align the sections of the output file. (Inherited from ManagedCompiler.)
Public propertyGenerateFullPathsInfrastructure. Gets or sets a Boolean value that indicates whether to generate the absolute path to the file in the compiler output (true) or to generate the name of the file in the compiler output (false).
Protected propertyHasLoggedErrorsInfrastructure. Returns whether this ToolTask has logged any errors. (Inherited from ToolTaskExtension.)
Protected propertyHelpKeywordPrefixGets or sets the prefix used to compose Help keywords from resource names. (Inherited from Task.)
Public propertyHighEntropyVAGets or sets the HighEntropyVA attribute. (Inherited from ManagedCompiler.)
Protected propertyHostCompilerSupportsAllParametersInfrastructure. Gets or sets a value indicating wheter the host compilter supports all task parameters. (Inherited from ManagedCompiler.)
Public propertyHostObjectGets or sets the host object associated with the task. (Inherited from Task.)
Public propertyKeyContainerInfrastructure. Gets or sets the name of the cryptographic key container. (Inherited from ManagedCompiler.)
Public propertyKeyFileInfrastructure. Gets or sets the file name containing the cryptographic key. (Inherited from ManagedCompiler.)
Public propertyLangVersionInfrastructure. Gets or sets the version of the language to use.
Public propertyLinkResourcesInfrastructure. Gets or sets the .NET Framework resource files to link to the output file. (Inherited from ManagedCompiler.)
Public propertyLogGets an instance of a TaskLoggingHelperExtension class containing task logging methods. (Inherited from ToolTaskExtension.)
Public propertyLogStandardErrorAsErrorShould ALL messages received on the standard error stream be logged as errors. (Inherited from ToolTask.)
Public propertyMainEntryPointInfrastructure. Gets or sets the class or module that contains the main entry point. (Inherited from ManagedCompiler.)
Public propertyModuleAssemblyNameInfrastructure. Gets or sets an assembly whose non-public types a .netmodule can access.
Public propertyNoConfigInfrastructure. Gets or sets a value indicating whether the compiler should use the default response file. (Inherited from ManagedCompiler.)
Public propertyNoLogoInfrastructure. Gets or sets a value indicating whether to suppress the compiler banner information. (Inherited from ManagedCompiler.)
Public propertyNoStandardLibInfrastructure. Gets or sets a Boolean value that indicates whether the Csc task should prevent the import of mscorlib.dll, which defines the entire System namespace.
Public propertyNoWin32ManifestInfrastructure. Gets or sets a Boolean value that specifies whether an external UAC manifest is generated for the application. (Inherited from ManagedCompiler.)
Public propertyOptimizeInfrastructure. Gets or sets a value indicating whether to enable compiler optimizations. (Inherited from ManagedCompiler.)
Public propertyOutputAssemblyInfrastructure. Gets or sets the name of the output file. (Inherited from ManagedCompiler.)
Public propertyPdbFileInfrastructure. Gets or sets the path of the .pdb file.
Public propertyPlatformGets or sets the Platform attribute. (Inherited from ManagedCompiler.)
Public propertyPrefer32BitGets or sets the Prefer32Bit attribute. (Inherited from ManagedCompiler.)
Public propertyPreferredUILangThe name of the language passed to the “/preferreduilang” compiler option.
Public propertyReferencesInfrastructure. Gets or sets the items from which the compiler will import public type information. (Inherited from ManagedCompiler.)
Public propertyResourcesInfrastructure. Gets or sets the .NET Framework resources to embed in the output file. (Inherited from ManagedCompiler.)
Protected propertyResponseFileEncodingGets the Encoding of the response file. (Inherited from ToolTask.)
Public propertyResponseFilesInfrastructure. Gets or sets the response files that contain commands for the task. (Inherited from ManagedCompiler.)
Public propertySourcesInfrastructure. Gets or sets the source files to compile. (Inherited from ManagedCompiler.)
Protected propertyStandardErrorEncodingGets the Encoding of the standard error stream of the task. (Inherited from ToolTask.)
Public propertyStandardErrorImportanceTask Parameter: Importance with which to log text from the standard error stream. (Inherited from ToolTask.)
Protected propertyStandardErrorImportanceToUseGets the actual importance at which standard error messages will be logged. (Inherited from ToolTask.)
Protected propertyStandardErrorLoggingImportanceGets the MessageImportance with which to log errors. (Inherited from ToolTask.)
Protected propertyStandardOutputEncodingInfrastructure. Gets or sets the encoding of the captured task standard output stream. (Inherited from ManagedCompiler.)
Public propertyStandardOutputImportanceTask Parameter: Importance with which to log text from the standard out stream. (Inherited from ToolTask.)
Protected propertyStandardOutputImportanceToUseGets the actual importance at which standard out messages will be logged. (Inherited from ToolTask.)
Protected propertyStandardOutputLoggingImportanceGets the MessageImportance with which to log errors. (Inherited from ToolTask.)
Public propertySubsystemVersionGets or sets the SubsystemVersion attribute value. (Inherited from ManagedCompiler.)
Public propertyTargetTypeInfrastructure. Gets or sets the file format of the output file. (Inherited from ManagedCompiler.)
Protected propertyTaskProcessTerminationTimeoutA timeout to wait for a task to terminate before killing it. In milliseconds. (Inherited from ToolTask.)
Protected propertyTaskResourcesGets or sets the culture-specific resources associated with the task. (Inherited from Task.)
Public propertyTimeoutGets or sets the amount of time after which the task executable is terminated. (Inherited from ToolTask.)
Protected propertyToolCanceledUsed to signal when a tool has been cancelled. (Inherited from ToolTask.)
Public propertyToolExeProjects may set this to override a task's ToolName. Tasks may override this to prevent that. (Inherited from ToolTask.)
Protected propertyToolNameInfrastructure. Returns the name of the Csc tool (csc.exe). (Overrides ToolTask.ToolName.)
Public propertyToolPathGets or sets the path of the executable file to run. (Inherited from ToolTask.)
Public propertyTreatWarningsAsErrorsInfrastructure. Gets or sets a value indicating whether warnings are treated as errors. (Inherited from ManagedCompiler.)
Public propertyUseCommandProcessorGets or sets a switch that specifies whether the tool task will create a batch file for the command-line and execute that using the command-processor, rather than executing the command directly. (Inherited from ToolTask.)
Protected propertyUsedCommandLineToolWhether the command line compiler was invoked, instead of the host object compiler. (Inherited from ManagedCompiler.)
Public propertyUseHostCompilerIfAvailableInfrastructure. Gets or sets a Boolean value that indicates whether the Csc task should use the in-process compiler object, if available.
Public propertyUtf8OutputInfrastructure. Gets or sets a value indicating whether compiler output is logged using UTF-8 encoding. (Inherited from ManagedCompiler.)
Public propertyWarningLevelInfrastructure. Gets or sets the warning level for the compiler to display.
Public propertyWarningsAsErrorsInfrastructure. Gets or sets a list of warnings to treat as errors.
Public propertyWarningsNotAsErrorsInfrastructure. Gets or sets a list of warnings that are not treated as errors.
Public propertyWin32IconInfrastructure. Gets or sets the icon file name. (Inherited from ManagedCompiler.)
Public propertyWin32ManifestInfrastructure. Gets or sets the Win32 manifest. (Inherited from ManagedCompiler.)
Public propertyWin32ResourceInfrastructure. Gets or sets a Win32 resource (.res) file to insert in the output file. (Inherited from ManagedCompiler.)
Public propertyYieldDuringToolExecutionIndicates if the task will yield the node during tool execution. (Inherited from ToolTask.)
Top

  NameDescription
Protected methodAddCommandLineCommandsInfrastructure. Generates command line arguments that the command line tool must run directly from the command line and not from a response file. (Inherited from ManagedCompiler.)
Protected methodAddResponseFileCommandsInfrastructure. Fills the specified commandLine parameter with switches and other information that can go into a response file. (Overrides ManagedCompiler.AddResponseFileCommands(CommandLineBuilderExtension).)
Protected methodCallHostObjectToExecuteInfrastructure. Compiles the project through the host object. (Overrides ToolTask.CallHostObjectToExecute().)
Public methodCancelCancels the process executing the task by asking it to close nicely, then after a short period, forcing termination. (Inherited from ToolTask.)
Protected methodCheckAllReferencesExistOnDiskInfrastructure. Verifies that all specified references exist on disk. (Inherited from ManagedCompiler.)
Protected methodCheckHostObjectSupportInfrastructure. Logs a message if the specified parameter is not supported by the host compiler. (Inherited from ManagedCompiler.)
Protected methodDeleteTempFileDeletes the specified temporary file. (Inherited from ToolTask.)
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Public methodExecuteRuns the exectuable file with the specified task parameters. (Inherited from ToolTask.)
Protected methodExecuteToolCreates a temporoary response (.rsp) file and runs the executable file. (Inherited from ToolTask.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Protected methodGenerateCommandLineCommandsInfrastructure. Gets the switches and other information that the command line tool must run directly from the command line and not from a response file. (Inherited from ToolTaskExtension.)
Protected methodGenerateFullPathToToolInfrastructure. Returns the full file path of the Csc tool. (Overrides ToolTask.GenerateFullPathToTool().)
Protected methodGenerateResponseFileCommandsInfrastructure. Gets the switch used by the command line tool to specify the response file. (Inherited from ToolTaskExtension.)
Protected methodGetBoolParameterWithDefaultInfrastructure. Gets the value of the specified Boolean parameter. (Inherited from ToolTaskExtension.)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Protected methodGetIntParameterWithDefaultInfrastructure. Gets the value of the specified integer parameter. (Inherited from ToolTaskExtension.)
Protected methodGetProcessStartInfoInitializes the information required to spawn the process executing the tool. (Inherited from ToolTask.)
Protected methodGetResponseFileSwitchReturns the command line switch used by the executable file to specifiy a response (.rsp) file. (Inherited from ToolTask.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodGetWorkingDirectoryReturns the directory in which to run the executable file. (Inherited from ToolTask.)
Protected methodHandleTaskExecutionErrorsInfrastructure. Handles the return code from the compiler. (Inherited from ManagedCompiler.)
Protected methodInitializeHostObjectInfrastructure. Returns a host object initialization status value that indicates what the next action should be. (Overrides ToolTask.InitializeHostObject().)
Protected methodListHasNoDuplicateItemsInfrastructure. Determines if any duplicate items exist in the specified task parameter. (Inherited from ManagedCompiler.)
Protected methodLogEventsFromTextOutputParses a single line of text to identify any errors or warnings in canonical format. (Inherited from ToolTask.)
Protected methodLogPathToToolLogs the tool name and path to all registered loggers. (Inherited from ToolTask.)
Protected methodLogToolCommandLogs the starting point of the run to all registered loggers. (Inherited from ToolTask.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Protected methodResponseFileEscapeOverridable method to escape the content of the response file. (Inherited from ToolTask.)
Protected methodSkipTaskExecutionIndicates whether task execution should be skipped. (Inherited from ToolTask.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Protected methodUseAlternateCommandLineToolToExecuteInfrastructure. If an alternate tool name or tool path was specified in the project file, then that tool is used rather than the host compiler for integrated development environment (IDE) builds. (Inherited from ManagedCompiler.)
Protected methodValidateParametersInfrastructure. Validates the task parameters. (Inherited from ManagedCompiler.)
Top

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Show:
© 2014 Microsoft