Table of Contents

Class GenerateShapeForAttribute

Namespace
PolyType
Assembly
PolyType.dll

Instructs the PolyType source generator to include target in the ITypeShapeProvider that it generates.

[AttributeUsage(AttributeTargets.Class|AttributeTargets.Struct, AllowMultiple = true, Inherited = false)]
[Conditional("NEVER")]
public sealed class GenerateShapeForAttribute : Attribute
Inheritance
GenerateShapeForAttribute
Inherited Members

Remarks

The source generator will include a static property in the annotated class pointing to the ITypeShapeProvider that was generated for the entire project.

For projects targeting .NET 8 or later, this additionally augments the class with an implementation of IShapeable for target.

Constructors

GenerateShapeForAttribute(Type)

Instructs the PolyType source generator to include target in the ITypeShapeProvider that it generates.

public GenerateShapeForAttribute(Type target)

Parameters

target Type

The type for which shape metadata will be generated. This must not be an open-generic type.

Remarks

The source generator will include a static property in the annotated class pointing to the ITypeShapeProvider that was generated for the entire project.

For projects targeting .NET 8 or later, this additionally augments the class with an implementation of IShapeable for target.

See Also

Properties

IncludeMethods

Gets the binding flags that determine what method or event shapes should be included in the type shape.

public MethodShapeFlags IncludeMethods { get; init; }

Property Value

MethodShapeFlags

Remarks

This property controls how the Methods and Events collections will be populated. If left unspecified, only methods annotated with MethodShapeAttribute or EventShapeAttribute will be included.

This type can only be used to control inclusion of public methods in the shape models. Non-public methods can only be included individually via explicit attribute annotations.

Kind

Gets the kind that should be generated for the annotated type.

public TypeShapeKind Kind { get; init; }

Property Value

TypeShapeKind

Remarks

Passing None will result in the generation of an IObjectTypeShape that does not contain any properties or constructors.

Exceptions

ArgumentOutOfRangeException

The specified value is not a valid TypeShapeKind.

Marshaler

Gets a type implementing an IMarshaler<TSource, TTarget> to a surrogate type.

public Type? Marshaler { get; init; }

Property Value

Type

Remarks

The type should have a parameterless constructor and must implement IMarshaler<TSource, TTarget> where either of the two generic types should match the annotated type.

Types that specify a Marshaler will be of shape ISurrogateTypeShape.

Target

Gets the target type being generated.

public Type Target { get; }

Property Value

Type

See Also