Aspect Injector 文档——注入切面

In the AspectInjector, injection is done by applying the trigger attribute to a target. Trigger is created by defining .net attribute class and marking it with [Injection] attribute.

在 AspectInjector 中，通过将[trigger]特性应用于目标来完成注入。Trigger被定义为.net特性类并用[Injection]特性标记它。

// defining aspect
[Aspect(Scope.Global)]
class LogAspect {}

// defining a trigger
[Injection(typeof(LogAspect))]
class Log : Attribute {}
//

After the trigger is defined you can apply it to the target:

定义了trigger之后，你可以在目标上应用此trigger：

class TestClass {
    [Log]
    public void DoSomething() {}
}

However the trigger is only an "attempt" to inject something into the target. When the trigger is fired for an aspect and the target then it is up to the aspect to decide if anything is injected. For instance if the aspect effects are configured to deal only with public members and the target doesn't have such then nothing is injected.

然而trigger只是注入的“尝试”。当trigger为某个aspect和目标触发时，是否注入任何东西取决于aspect。例如，如果aspect effects被配置为只处理公共成员，而目标没有公共成员，那么就不会注入任何东西。

Multi-trigger  多trigger

Triggers can be defined to inject multiple aspects at a time.

可以定义Triggers来一次注入多个aspects。

// defining log aspect
[Aspect(Scope.Global)]
class LogAspect {}

// defining measure execution time aspect
[Aspect(Scope.Global)]
class MeasureAspect {}

// defining a trigger
[Injection(typeof(LogAspect))]
[Injection(typeof(MeasureAspect))]
class LogAll : Attribute {}

Injection propagation  注入传播

Trigger propagates injection to submembers of a target. This behaviour will be customizable in future versions.

Trigger 将注入传播到目标的子成员。这种行为在将来的版本中是可定制的。

[Log]
class TestClass {
    public void DoSomething() {}
    public void DoSomethingElse() {}
}

// equals to

class TestClass {
    [Log]
    public void DoSomething() {}
    [Log]
    public void DoSomethingElse() {}
}

// and in case your dll has the only class - equals to
[assembly: Log]

Triggers and parameters  Triggers与参数

Triggers can carry parameters which can be read by an Aspect to execute additional logic.

Trggers可以携带参数，Aspect可以读取这些参数以执行其他逻辑。

[Injection(typeof(LogAspect))]
class Log : Attribute {

    public Level Level { get; }

    public Log (LogLevel level){
        Level = level;
    }
}

class TestClass {
    [Log(Level.Warning)]
    public void DoSomething() {}
}

Injection suppression  注入禁止

If there is a need to skip injection in some cases, there is an attribute SkipInjection, which can annotate classes, constructors, methods, properties, and events. Once applied, it suppresses any injections to the target.

如果在某些情况下需要跳过注入，有一个[SkipInjection]特性可供使用，它可以装饰类，构造函数，方法，属性和事件。一旦应用此特性，它会禁止目标上的任何注入。

Please note that inheritance is not taken into account - applying the attribute to a base class doesn't suppress injections to its descendants.

请注意，继承不在考虑范围之内——为基类应用此特性，不会在其子类上禁止注入。