Open sandboxFocus

Method IntroduceConstructor

IntroduceConstructor(IAdviser<INamedType>, string, OverrideStrategy, Action<IConstructorBuilder>?, object?, object?)

Introduces a constructor to the target type, or overrides the implementation of an existing one. Use the With<TNewDeclaration>(TNewDeclaration) method to apply the advice to another type than the current one.

Declaration
public static IIntroductionAdviceResult<IConstructor> IntroduceConstructor(this IAdviser<INamedType> adviser, string template, OverrideStrategy whenExists = OverrideStrategy.Default, Action<IConstructorBuilder>? buildConstructor = null, object? args = null, object? tags = null)
Parameters
Type Name Description
IAdviser<INamedType> adviser

An adviser for a named type.

string template

Name of the method of the aspect class that will be used as a template for the introduced constructor. This method must be annotated with TemplateAttribute. The parameters of this method will be copied to the introduced constructor.

OverrideStrategy whenExists

Determines the implementation strategy when a constructor of the same signature is already declared in the target type. The default strategy is to fail with a compile-time error.

Action<IConstructorBuilder> buildConstructor

An optional delegate to customize the introduced constructor via IConstructorBuilder.

object args

An optional object (typically of anonymous type) whose properties map to template method parameters or type parameters. See Sharing state with adviceSharing state with advice for details.

object tags

An optional object (typically of anonymous type) passed to the template and accessible via meta.Tags. See Sharing state with adviceSharing state with advice for details.

Returns
Type Description
IIntroductionAdviceResult<IConstructor>

An IIntroductionAdviceResult<T> exposing the introduced or overriding IConstructor.

See Also