PartialClassGenerationTask Class

Definition

Accesses XAML files that define types (with x:Class) and generates the corresponding source code that can be compiled into an assembly.

public ref class PartialClassGenerationTask : Microsoft::Build::Utilities::Task
public class PartialClassGenerationTask : Microsoft.Build.Utilities.Task
type PartialClassGenerationTask = class
    inherit Task
Public Class PartialClassGenerationTask
Inherits Task
Inheritance
PartialClassGenerationTask

Remarks

The XAML files processed by this task define new types as well as instantiate those types. The PartialClassGenerationTask class reads in the new type definitions and generates source code files. In addition, it generates a XAML file that contains the markup that instantiates the newly generated types.

This task should not be used to consume untrusted XAML inputs.

Constructors

PartialClassGenerationTask()

Initializes a new instance of the PartialClassGenerationTask class.

Properties

ApplicationMarkup

Gets or sets a list of XAML files to process, populated by MS Build.

AssemblyName

Gets or sets the name of the assembly being compiled.

BuildEngine

The build engine automatically sets this property to allow tasks to call back into it.

(Inherited from Task)
BuildEngine2

The build engine automatically sets this property to allow tasks to call back into it. This is a convenience property so that task authors inheriting from this class do not have to cast the value from IBuildEngine to IBuildEngine2.

(Inherited from Task)
BuildEngine3

Retrieves the IBuildEngine3 version of the build engine interface provided by the host.

(Inherited from Task)
BuildEngine4

Retrieves the IBuildEngine4 version of the build engine interface provided by the host.

(Inherited from Task)
BuildEngine5

Retrieves the IBuildEngine5 version of the build engine interface provided by the host.

(Inherited from Task)
BuildEngine6

Retrieves the IBuildEngine6 version of the build engine interface provided by the host.

(Inherited from Task)
BuildEngine7

Retrieves the IBuildEngine7 version of the build engine interface provided by the host.

(Inherited from Task)
BuildEngine8

Retrieves the IBuildEngine8 version of the build engine interface provided by the host.

(Inherited from Task)
BuildEngine9

Retrieves the IBuildEngine9 version of the build engine interface provided by the host.

(Inherited from Task)
BuildTaskPath

Gets or sets the path of the assembly that contains this build task.

GeneratedCodeFiles

Gets or sets a list of generated code files, one for each input file.

GeneratedResources

Gets or sets a list of XAML files that contain the markup for instantiating the newly generated types, one for each input file.

GeneratedSourceExtension

Gets or sets the file extension to add to the generated source files.

HelpKeywordPrefix

Gets or sets the prefix used to compose help keywords from string resource names. If a task does not have help keywords associated with its messages, it can ignore this property or set it to null. If the prefix is set to an empty string, then string resource names will be used verbatim as help keywords. For an example of how this prefix is used, see the TaskLoggingHelper.LogErrorWithCodeFromResources(string, object[]) method.

(Inherited from Task)
HostObject

The build engine sets this property if the host IDE has associated a host object with this particular task.

(Inherited from Task)
IsInProcessXamlMarkupCompile

Gets or sets whether the compilation of XAML markup is in process.

KnownReferencePaths

Gets or sets the known reference paths.

Language

Gets or sets the language to generate source code in.

Log

Gets an instance of a TaskLoggingHelper class containing task logging methods. The taskLoggingHelper is a MarshallByRef object which needs to have MarkAsInactive called if the parent task is making the appdomain and marshaling this object into it. If the appdomain is not unloaded at the end of the task execution and the MarkAsInactive method is not called this will result in a leak of the task instances in the appdomain the task was created within.

(Inherited from Task)
MSBuildProjectDirectory

Gets or sets the directory of MS build project.

OutputPath

Gets or sets the directory to place the generated files.

References

Gets or sets a list of assemblies to reference.

RequiresCompilationPass2

Gets or sets a value that indicates whether this project requires executing the CompilationPass2Task task.

RootNamespace

Gets or sets the root namespace for the project.

SourceCodeFiles

Gets or sets a list of source code files in the project.

TaskResources

Gets or sets the task's culture-specific resources. Derived classes should register their resources either during construction, or via this property, if they have localized strings.

(Inherited from Task)
XamlBuildTypeGenerationExtensionNames

Gets or sets the collection of extension names used in XAML build type generation.

XamlBuildTypeInspectionExtensionNames

Gets or sets the collection of extension names used in XAML build type inspection.

Methods

Execute()

Called by MS Build to execute the code generation task.

Applies to