通过

特性目标（C++/CLI 和 C++/CX）

  • 项目

特性用法说明符允许指定特性目标。 每个特性定义为应用于特定的语言元素。 例如，某个特征可能定义为仅应用于类和结构。 以下列表演示了自定义属性可以使用的语法元素。 可以结合使用这些值（使用逻辑或）。

要指定特性目标，则在定义特性时将一个或多个 AttributeTargets 枚举数传递到 AttributeUsageAttribute。

以下列表显示了有效的特性目标：

  • All（应用于所有构造函数）

    using namespace System;
[AttributeUsage(AttributeTargets::All)]
ref class Attr : public Attribute {};

[assembly:Attr];

  • Assembly（应用于整个程序集）

    using namespace System;
[AttributeUsage(AttributeTargets::Assembly)]
ref class Attr : public Attribute {};

[assembly:Attr];

  • Module（应用于整个模块）

    using namespace System;
[AttributeUsage(AttributeTargets::Module)]
ref class Attr : public Attribute {};

[module:Attr];

  • Class

    using namespace System;
[AttributeUsage(AttributeTargets::Class)]
ref class Attr : public System::Attribute {};

[Attr]   // same as [class:Attr]
ref class MyClass {};

  • Struct

    using namespace System;
[AttributeUsage(AttributeTargets::Struct)]
ref class Attr : public Attribute {};

[Attr]   // same as [struct:Attr]
value struct MyStruct{};

  • enum

    using namespace System;
[AttributeUsage(AttributeTargets::Enum)]
ref class Attr : public Attribute {};

[Attr]   // same as [enum:Attr]
enum struct MyEnum{e, d};

  • Constructor

    using namespace System;
[AttributeUsage(AttributeTargets::Constructor)]
ref class Attr : public Attribute {};

ref struct MyStruct{
[Attr] MyStruct(){}   // same as [constructor:Attr]
};

  • Method

    using namespace System;
[AttributeUsage(AttributeTargets::Method)]
ref class Attr : public Attribute {};

ref struct MyStruct{
[Attr] void Test(){}   // same as [method:Attr]
};

  • Property

    using namespace System;
[AttributeUsage(AttributeTargets::Property)]
ref class Attr : public Attribute {};

ref struct MyStruct{
[Attr] property int Test;   // same as [property:Attr]
};

  • Field

    using namespace System;
[AttributeUsage(AttributeTargets::Field)]
ref class Attr : public Attribute {};

ref struct MyStruct{
[Attr] int Test;   // same as [field:Attr]
};

  • Event

    using namespace System;
[AttributeUsage(AttributeTargets::Event)]
ref class Attr : public Attribute {};

delegate void ClickEventHandler(int, double);

ref struct MyStruct{
[Attr] event ClickEventHandler^ OnClick;   // same as [event:Attr]
};

  • Interface

    using namespace System;
[AttributeUsage(AttributeTargets::Interface)]
ref class Attr : public Attribute {};

[Attr]   // same as [event:Attr]
interface struct MyStruct{};

  • Parameter

    using namespace System;
[AttributeUsage(AttributeTargets::Parameter)]
ref class Attr : public Attribute {};

ref struct MyStruct{
void Test([Attr] int i);
void Test2([parameter:Attr] int i);
};

  • Delegate

    using namespace System;
[AttributeUsage(AttributeTargets::Delegate)]
ref class Attr : public Attribute {};

[Attr] delegate void Test();
[delegate:Attr] delegate void Test2();

  • ReturnValue

    using namespace System;
[AttributeUsage(AttributeTargets::ReturnValue)]
ref class Attr : public Attribute {};

ref struct MyStruct {
// Note required specifier
[returnvalue:Attr] int Test() { return 0; }
};

通常，特性直接优先于其应用到的语言元素。 但是，在某些情况下，特性的位置不足以确定特性的预期目标。 请看以下示例：

[Attr] int MyFn(double x)...

语法上，无法知道特性应用于方法还是方法的返回值（在本例中，默认为应用于方法）。 在这种情况下，可以使用特性用法说明符。 例如，要使特性应用于返回值，应使用 returnvalue 说明符，如下所示：

[returnvalue:Attr] int MyFn(double x)... // applies to return value

以下情况下需要特性用法说明符：

  • 指定程序集或模块级别的特性。

  • 指定特性应用于方法的返回值，而不是方法：

    [method:Attr] int MyFn(double x)...     // Attr applies to method
[returnvalue:Attr] int MyFn(double x)...// Attr applies to return value
[Attr] int MyFn(double x)...            // default: method

  • 指定特性应用于属性的访问器，而不是属性：

    [method:MyAttr(123)] property int Property()
[property:MyAttr(123)] property int Property()
[MyAttr(123)] property int get_MyPropy() // default: property

  • 指定特性应用于事件的访问器，而不是事件：

    delegate void MyDel();
ref struct X {
   [field:MyAttr(123)] event MyDel* MyEvent;   //field
   [event:MyAttr(123)] event MyDel* MyEvent;   //event
   [MyAttr(123)] event MyDel* MyEvent;   // default: event
}

特性用法说明符仅应用于紧跟其后的特性；即

[returnvalue:Attr1, Attr2]

不同于

[returnvalue:Attr1, returnvalue:Attr2]

示例

说明

此示例演示如何指定多个目标。

代码

using namespace System;
[AttributeUsage(AttributeTargets::Class | AttributeTargets::Struct, AllowMultiple = true )]
ref struct Attr : public Attribute {
   Attr(bool i){}
   Attr(){}
};

[Attr]
ref class MyClass {};

[Attr]
[Attr(true)]
value struct MyStruct {};

另请参阅

用户定义的属性