attributeusage([AttributeUsage(AttributeTargets.Class)] 这是什么用法)

大家好，今天我将为大家揭秘attributeusage和[AttributeUsage(AttributeTargets.Class)] 这是什么用法的奥秘，希望我的分享能给你带来新的启发和知识。

property和attribute的区别

property是指类向外提供的数据区域。

而attribute则是描述对象在编译时或运行时属性的，分为固有型和用户自定义型，其中用户自定义型可以利用Reflection在运行期获取。

这两者是有本质区别的。

资料上说二者一个是service的属性，而另一个是interface的。

第一种好象更准确,摘要如下：

在很多人的脑海中，Attribute就是类的属性，Property呢？好像也是类的属性？因此有很多人不加区别的统一称为类的属性，尤其是在写中文文章的时候。这种心理是典型的鸵鸟心态，眼不见为净。其实稍微用脚想一下就知道，事实肯定不是这样的，UML中既然发明了这两个术语，显然不是用来冗余的。它们之间肯定有着千丝万缕的联系与区别。

各种各样的面向对象语言、各种组件技术、模板技术、Web Service技术，其中大部分涉及到了“属性”这个概念，而其英文术语则常常是Attribute、Property或者Field。很多人一概称之为“属性”，有的地方确实可以不加区分，但有的地方却是差之毫厘、谬以千里。我对于这些纷纷扰扰的技术和术语也很苦恼，但是我们至少可以通过UML中的这两个术语的解释找到一个可以参考的标准。无论如何，UML是面向对象技术的集大成者和事实上的标准。

很客观的说，UML1.4中对于这两个术语并没有很清晰的定义，但是其区别还是显而易见的。Attribute应该是UML1.4中的宠儿，而Property连一个单独的术语都没有捞到。谁也没想到在UML2.0中风云突变，Attribute从类图中消失了，而Property堂而皇之入主中原。

1。4中 Attribute是与Classifier相关联的术语，它比Property的影响范围要小。Class是Classifier的子类，因此Attribute也可以表示Class的属性。从上面的定义还可以看出，Attribute可以是Classifier的实例的命名的槽。对于Class来说，其实例就是Object，Object的槽就是对象的属性值槽。因此，Attribute是可以作为对象的属性的。而Property似乎没有这一层的含义。按MOF（元对象设施，OMG的另一个规范，后面会有详细解释）的模型层次划分，Attribute涉及的模型层从M2到M0，而Property似乎只是M2层的概念。

2。0中 Attribute这里仅仅指一个类元的结构特征，可以将类元的实例联系到一个或者一组具体值。而没有提到实例的槽（slot）等等。我猜想，这是因为UML2.0中已经把Attribute作为Property的一个子集了，所以关于实例的槽（slot）等等的具体赋值方法，都归结到Property的定义中解释了。

另外一点值得注意的是，Attribute的定义来自于术语表，而没有在元模型图中出现。而Property出现在元模型图中，并且都做了详细而具体的解释。这一点可以看出，UML强化Property，弱化Attribute的决心。

Attribute和Property的总结

这一节对Attribute和Property作一个小结，基于目前最新的UML2.0规范：

l总体上来说，Attribute是Property的子集，Property会在适当的时机表现为Attribute；

l Property出现在类图的元模型中，代表了Class的所有结构化特征；Attribute没有出现在元模型中，它仅仅在Class的概念中存在，没有相应的语法了；

l Property有详细的定义和约束，而Attribute没有详细的定义，因此也不能用OCL写出其约束。

l Property和Attribute都是M2层的概念。在M1层，它们的实例是具体类的属性；在M0层，它们的实例的实例是具体对象的槽中存储的值。

对于property和attribute这两个名词都叫“属性”的问题，来源于国内it书籍翻译界的疏忽。

其实它们来源于两个不同的领域，attribute属于OOA/OOD的概念，而property属于编程语言中的概念。下面我们来说明它们的异同。

Attribute

Attributes是Microsoft.NET Framework文件的元数据，可以用来向运行时描述你的代码，或者在程序运行的时候影响应用程序的行为。

Property

属性是面向对象编程的基本概念，提供了对私有字段的访问封装，在C#中以get和set访问器方法实现对可读可写属性的操作，提供了安全和灵活的数据访问封装。关于属性的概念，不是本文的重点，而且相信大部分的技术人员应该对属性有清晰的概念。以下是简单的属性

区别

可以说两者没有可比性，只不过我们国家的语言特点才引起的歧异，其实只要记住Attribute是派生于System,Attribute类之下，它的主要作用是描述，比如某为了描述某个方法是来自与外部的dll，

可以写如下代码，这就是一个Attribute，他是一个描述（或者说声明）

[DllImport("User32.dll")]

Attribute也有很多系统的“默认”属性，见下表

预定义的属性

有效目标

说明

AttributeUsage

Class

指定另一个属性类的有效使用方式

CLSCompliant

全部

指出程序元素是否与CLS兼容

Conditional

Method

指出如果没有定义相关联的字符串，编译器就可以忽略对这个方法的任何调用

DllImport

Method

指定包含外部方法的实现的DLL位置

STAThread

Method(Main)

指出程序的默认线程模型为STA

MTAThread

Method(Main)

指出程序的默认模型为多线程(MTA)

Obsolete

除了Assembly、Module、Parameter和Return

将一个元素标示为不可用，通知用户此元素将被从未来的产品

ParamArray

Parameter

允许单个参数被隐式地当作params(数组)参数对待

Serializable

Class、Struct、enum、delegate

指定这种类型的所有公共和私有字段可以被串行化

NonSerialized

Field

应用于被标示为可串行化的类的字段，指出这些字段将不可被串行化

StructLayout

Class、struct

指定类或结构的数据布局的性质，比如Auto、Explicit或sequential

ThreadStatic

Field(静态)

实现线程局部存储(TLS)。不能跨多个线程共享给定的静态字段，每个线程拥有这个静态字段的副本

而Property是指编程过程中的字段，也即类的成员。

如：

private int hour;//定义私有变量表示"小时",外部是访问不到的.}

public int Hour//定义Hour程序接口

{

set{ hour=value;}

get{ return hour;}

[AttributeUsage(AttributeTargets.Class)] 这是什么用法

其是这个是创建自定义特性的用法。

通过定义一个特性类，可以创建您自己的自定义特性。该特性类直接或间接地从 Attribute派生，有助于方便快捷地在元数据中标识特性定义。假设您要用编写类型的程序员的名字标记类型。你的例子是一个自定义 VersionAttribute特性类：

类名是特性的名称，即 VersionAttribute。它由 Attribute派生而来，因此是自定义特性类。构造函数的参数是自定义特性的定位参数。任何公共的读写字段或属性都是命名参数。你的代码里面Name,Date,Description都是的命名参数。请注意 AttributeUsage特性的用法，它使得 VersionAttribute特性仅在类和 struct声明中有效。

C# 特性(Attribute)学习

特性（attribute）是被指定给某一声明的一则附加的声明性信息。

在C#中，有一个小的预定义特性集合。在学习如何建立我们自己的定制特性（custom attributes）之前，我们先来看看在我们的代码中如何使用预定义特性。

using System;

public class AnyClass

{

[Obsolete（"Don't use Old method, use New method", true）]

static void Old（）{}

static void New（）{}

public static void Main（）

{

Old（）；

}

}

我们先来看一下上面这个例子，在这个例子中我们使用了Obsolete特性，它标记了一个不应该再被使用的程序实体。第一个参数是一个字符串，它解释了为什么该实体是过时的以及应该用什么实体来代替它。实际上，你可以在这里写任何文本。第二个参数告诉编译器应该把使用这个过时的程序实体当作一种错误。它的默认值是false，也就是说编译器对此会产生一个警告。

当我们尝试编译上面这段程序的时候，我们将会得到一个错误：

AnyClass.Old（）' is obsolete:'Don't use Old method, use New method'

开发定制特性（custom attributes）

现在让我们来看看如何开发我们自己的特性。

首先我们要从System.Attribute派生出我们自己的特性类（一个从System.Attribute抽象类继承而来的类，不管是直接还是间接继承，都会成为一个特性类。特性类的声明定义了一种可以被放置在声明之上新的特性）。

using System;

public class HelpAttribute: Attribute

{

}

不管你是否相信，我们已经建立了一个定制特性，现在我们可以用它来装饰现有的类就好像上面我们使用Obsolete attribute一样。

[Help（）]

public class AnyClass

{

}

注意：对一个特性类名使用Attribute后缀是一个惯例。然而，当我们把特性添加到一个程序实体，是否包括Attribute后缀是我们的自由。编译器会首先在System.Attribute的派生类中查找被添加的特性类。如果没有找到，那么编译器会添加Attribute后缀继续查找。

到目前为止，这个特性还没有起到什么作用。下面我们来添加些东西给它使它更有用些。

using System;

public class HelpAttribute: Attribute

{

public HelpAttribute（String Descrition_in）

{

this.description= Description_in;

}

protected String description;

public String Description

{

get

{

return this.description;

}

}

}

[Help（"this is a do-nothing class"）]

public class AnyClass

{

}

在上面的例子中，我们给HelpAttribute特性类添加了一个属性并且在后续的部分中我们会在运行时环境中查寻它。

定义或控制特性的使用

AttributeUsage类是另外一个预定义特性类，它帮助我们控制我们自己的定制特性的使用。它描述了一个定制特性如和被使用。

AttributeUsage有三个属性，我们可以把它放置在定制属性前面。第一个属性是：

ValidOn

通过这个属性，我们能够定义定制特性应该在何种程序实体前放置。一个属性可以被放置的所有程序实体在AttributeTargets enumerator中列出。通过OR操作我们可以把若干个AttributeTargets值组合起来。

AllowMultiple

这个属性标记了我们的定制特性能否被重复放置在同一个程序实体前多次。

Inherited

我们可以使用这个属性来控制定制特性的继承规则。它标记了我们的特性能否被继承。

下面让我们来做一些实际的东西。我们将会在刚才的Help特性前放置AttributeUsage特性以期待在它的帮助下控制Help特性的使用。

using System;

[AttributeUsage（AttributeTargets.Class）， AllowMultiple= false,

Inherited= false ]

public class HelpAttribute: Attribute

{

public HelpAttribute（String Description_in）

{

this.description= Description_in;

}

protected String description;

public String Description

{

get

{

return this.description;

}

}

}

先让我们来看一下AttributeTargets.Class。它规定了Help特性只能被放在class的前面。这也就意味着下面的代码将会产生错误：

[Help（"this is a do-nothing class"）]

public class AnyClass

{

[Help（"this is a do-nothing method"）]//error

public void AnyMethod（）

{

}

}

编译器报告错误如下：

AnyClass.cs: Attribute'Help' is not valid on this declaration type.

It is valid on'class' declarations only.

我们可以使用AttributeTargets.All来允许Help特性被放置在任何程序实体前。可能的值是：

Assembly,Module,Class,Struct,Enum,Constructor,Method,Property,Field,Event,Interface,

Parameter,Delegate。

All= Assembly| Module| Class| Struct| Enum| Constructor| Method| Property| Field| Event| Interface| Parameter| Delegate,

ClassMembers= Class| Struct| Enum| Constructor| Method| Property| Field| Event| Delegate| Interface）

下面考虑一下AllowMultiple= false。它规定了特性不能被重复放置多次。

[Help（"this is a do-nothing class"）]

[Help（"it contains a do-nothing method"）]

public class AnyClass

{

[Help（"this is a do-nothing method"）]//error

public void AnyMethod（）

{

}

}

它产生了一个编译期错误。

AnyClass.cs: Duplicate'Help' attribute

Ok,现在我们来讨论一下最后的这个属性。Inherited,表明当特性被放置在一个基类上时，它能否被派生类所继承。

[Help（"BaseClass"）]

public class Base

{

}

public class Derive: Base

{

}

这里会有四种可能的组合：

[AttributeUsage（AttributeTargets.Class, AllowMultiple= false, Inherited= false ]

[AttributeUsage（AttributeTargets.Class, AllowMultiple= true, Inherited= false ]

[AttributeUsage（AttributeTargets.Class, AllowMultiple= false, Inherited= true ]

[AttributeUsage（AttributeTargets.Class, AllowMultiple= true, Inherited= true ]

第一种情况：

如果我们查询（Query）（稍后我们会看到如何在运行期查询一个类的特性）Derive类，我们将会发现Help特性并不存在，因为inherited属性被设置为false。

第二种情况：

和第一种情况相同，因为inherited也被设置为false。

第三种情况：

为了解释第三种和第四种情况，我们先来给派生类添加点代码：

[Help（"BaseClass"）]

public class Base

{

}

[Help（"DeriveClass"）]

public class Derive: Base

{

}

现在我们来查询一下Help特性，我们只能得到派生类的属性，因为inherited被设置为true，但是AllowMultiple却被设置为false。因此基类的Help特性被派生类Help特性覆盖了。

第四种情况：

在这里，我们将会发现派生类既有基类的Help特性，也有自己的Help特性，因为AllowMultiple被设置为true。

定义或控制特性的使用

AttributeUsage类是另外一个预定义特性类，它帮助我们控制我们自己的定制特性的使用。它描述了一个定制特性如和被使用。

AttributeUsage有三个属性，我们可以把它放置在定制属性前面。第一个属性是：

ValidOn

通过这个属性，我们能够定义定制特性应该在何种程序实体前放置。一个属性可以被放置的所有程序实体在AttributeTargets enumerator中列出。通过OR操作我们可以把若干个AttributeTargets值组合起来。

AllowMultiple

这个属性标记了我们的定制特性能否被重复放置在同一个程序实体前多次。

Inherited

我们可以使用这个属性来控制定制特性的继承规则。它标记了我们的特性能否被继承。

下面让我们来做一些实际的东西。我们将会在刚才的Help特性前放置AttributeUsage特性以期待在它的帮助下控制Help特性的使用。

using System;

[AttributeUsage（AttributeTargets.Class）， AllowMultiple= false,

Inherited= false ]

public class HelpAttribute: Attribute

{

public HelpAttribute（String Description_in）

{

this.description= Description_in;

}

protected String description;

public String Description

{

get

{

return this.description;

}

}

}

先让我们来看一下AttributeTargets.Class。它规定了Help特性只能被放在class的前面。这也就意味着下面的代码将会产生错误：

[Help（"this is a do-nothing class"）]

public class AnyClass

{

[Help（"this is a do-nothing method"）]//error

public void AnyMethod（）

{

}

}

编译器报告错误如下：

AnyClass.cs: Attribute Help is not valid on this declaration type.

It is valid on class declarations only.

我们可以使用AttributeTargets.All来允许Help特性被放置在任何程序实体前。可能的值是：

Assembly,

Module,

Class,

Struct,

Enum,

Constructor,

Method,

Property,

Field,

Event,

Interface,

Parameter,

Delegate,

All= Assembly| Module| Class| Struct| Enum| Constructor| Method| Property| Field| Event| Interface| Parameter| Delegate,下面考虑一下AllowMultiple= false。它规定了特性不能被重复放置多次。

[Help（"this is a do-nothing class"）]

[Help（"it contains a do-nothing method"）]

public class AnyClass

{

[Help（"this is a do-nothing method"）]//error

public void AnyMethod（）

{

}

}

它产生了一个编译期错误。

AnyClass.cs: Duplicate Help attribute

Ok,现在我们来讨论一下最后的这个属性。Inherited,表明当特性被放置在一个基类上时，它能否被派生类所继承。

[Help（"BaseClass"）]

public class Base

{

}

public class Derive: Base

{

}

这里会有四种可能的组合：

[AttributeUsage（AttributeTargets.Class, AllowMultiple= false, Inherited= false ]

[AttributeUsage（AttributeTargets.Class, AllowMultiple= true, Inherited= false ]

[AttributeUsage（AttributeTargets.Class, AllowMultiple= false, Inherited= true ]

[AttributeUsage（AttributeTargets.Class, AllowMultiple= true, Inherited= true ]

第一种情况：

如果我们查询（Query）（稍后我们会看到如何在运行期查询一个类的特性）Derive类，我们将会发现Help特性并不存在，因为inherited属性被设置为false。

第二种情况：

和第一种情况相同，因为inherited也被设置为false。

第三种情况：

为了解释第三种和第四种情况，我们先来给派生类添加点代码：

[Help（"BaseClass"）]

public class Base

{

}

[Help（"DeriveClass"）]

public class Derive: Base

{

}

现在我们来查询一下Help特性，我们只能得到派生类的属性，因为inherited被设置为true，但是AllowMultiple却被设置为false。因此基类的Help特性被派生类Help特性覆盖了。

第四种情况：

在这里，我们将会发现派生类既有基类的Help特性，也有自己的Help特性，因为AllowMultiple被设置为true。

ClassMembers= Class| Struct| Enum| Constructor| Method| Property| Field| Event| Delegate| Interface）

attributeusage的介绍就聊到这里吧，感谢你花时间阅读本站内容，更多关于[AttributeUsage(AttributeTargets.Class)] 这是什么用法、attributeusage的信息别忘了在本站进行查找哦。