代码约定规范

信息与代码程序集、类型、方法、属性等相关联的强大方法。

将属性与程序实体关联后可以在

运行时

属性将元数据添加到程序中。

元数据是有关程序中定义的类型的信息。

所有

.NET

程序集都包含一组指定的元数据用于描述程序集中定义的类型和类型成员。

您可以添加自定义属性以指定所需的任何其他信息。

您可以将一个或多个属性应用于整个程序集、模块或较小的程序元素例如类和属性。

Attributes

methods

一样接受参数。

您的程序可以使用反射检查自己的元数据或其他程序中的元数据。

Type。

您可以使用反射动态创建类型的实例将类型绑定到现有对象或者从现有对象获取类型并调用其方法或访问其字段和属性。

如果您在代码中使用属性则反射使您能够访问它们。

GetType

方法由基类中的所有类型继承获取变量类型的反射的简单示例Object

确保在

IsFamilyOrAssembly。

protectedinternalinternalprotected

internal

属性几乎可以放置在任何声明上尽管特定属性可能会限制它有效的声明类型。

在

括起来的特性名称放在应用该特性的实体的声明上方来指定特性。

[]

属性用于将特定特征应用于类

[System.Runtime.InteropServices.DllImport(user32.dll)]

extern

SampleMethod();可以在声明上放置多个属性如下例所示

void

库中的其他项区分开来。

但是在代码中使用属性时无需指定属性后缀。

例如等效于

.NET

类库中属性的实际名称。

[DllImport][DllImportAttribute]DllImportAttribute

1.2

named。

任何位置参数都必须按特定顺序指定并且不能省略。

命名参数是可选的可以按任意顺序指定。

首先指定位置参数。

例如这三个属性是等效的

SetLastErrorfalse,

名称是位置参数始终排在最前面;其他的都被命名了。

在这种情况下两个命名参数都默认为

false因此可以省略它们。

位置参数对应于属性构造函数的参数。

命名参数或可选参数对应于属性的属性或字段。

有关默认参数值的信息请参阅单个属性的文档。

Attributes

属性的目标是属性应用到的实体。

例如特性可能应用于类、特定方法或整个程序集。

默认情况下属性适用于其后面的元素。

但是您也可以显式标识例如属性是应用于方法、参数还是返回值。

[target

attribute-list]下表显示了可能的值列表。

target

您可以指定目标值以将属性应用于为自动实现的属性创建的支持字段。

field

下面的示例演示如何将属性应用于程序集和模块。

有关更多信息请参见

using

AssemblyTitleAttribute(Production

assembly

}无论定义有效的目标是什么都必须指定目标即使目标定义为仅应用于返回值也是如此。

换句话说编译器不会使用信息来解决不明确的属性目标。

有关更多信息请参阅

AttributeUsage。

ValidatedContractreturnValidatedContractAttributeUsage

1.4

WebMethodAttribute。

WebMethod描述在与本机代码互操作时如何封送方法参数。

有关详细信息请参阅

COM

类调用非托管代码。

根据标题、版本、描述或商标来描述程序集。

描述要序列化的类的哪些成员以实现持久性。

描述如何在类成员和

XML

序列化。

描述方法的安全要求。

指定用于强制实施安全性的特征。

通过即时

JIT

当您必须访问程序元数据中的属性时。

有关更多信息请参阅检索存储在属性中的信息。

用于检查和实例化程序集中的类型。

用于在运行时构建新类型。

使用

中的类。

为了执行后期绑定访问在运行时创建的类型的方法。

请参阅动态加载和使用类型一文。

二、创建自定义特性

[System.AttributeUsage(System.AttributeTargets.Class

|System.AttributeTargets.Struct)

public

AllowMultiple通过此命名参数可一次或多次使用自定义特性。

[System.AttributeUsage(System.AttributeTargets.Class

|System.AttributeTargets.Struct,AllowMultiple

true)

你可以定义自定义特性并将其放入源代码中这一事实在没有检索该信息并对其进行操作的方法的情况下将没有任何价值。

GetCustomAttributes它返回对象数组这些对象在运行时等效于源代码特性。

有关详细信息请参阅

之后你便可以循环访问此数组根据每个数组元素的类型确定所应用的特性并从特性对象中提取信息。

Multiuse

[System.AttributeUsage(System.AttributeTargets.Class

|System.AttributeTargets.Struct,AllowMultiple

true)

Test(){PrintAuthorInfo(typeof(FirstClass));PrintAuthorInfo(typeof(SecondClass));PrintAuthorInfo(typeof(ThirdClass));}private

static

t){System.Console.WriteLine($Author

information

System.Attribute.GetCustomAttributes(t);

Reflection.//

StructLayout(LayoutKind.Explicit)

FieldOffset

[System.Runtime.InteropServices.StructLayout(LayoutKind.Explicit)]

struct

{[System.Runtime.InteropServices.FieldOffset(0)]public

int

i;[System.Runtime.InteropServices.FieldOffset(0)]public

double

d;[System.Runtime.InteropServices.FieldOffset(0)]public

char

c;[System.Runtime.InteropServices.FieldOffset(0)]public

byte

[System.Runtime.InteropServices.StructLayout(LayoutKind.Explicit)]

struct

{[System.Runtime.InteropServices.FieldOffset(0)]public

long

lg;[System.Runtime.InteropServices.FieldOffset(0)]public

int

i1;[System.Runtime.InteropServices.FieldOffset(4)]public

int

i2;[System.Runtime.InteropServices.FieldOffset(8)]public

double

d;[System.Runtime.InteropServices.FieldOffset(12)]public

char

c;[System.Runtime.InteropServices.FieldOffset(14)]public

byte

但是只能将特性应用于开放式泛型类型和封闭式构造泛型类型而不能应用于部分构造泛型类型。

DictionaryTKey,

未绑定泛型类型是省略类型参数的泛型类型例如Dictionary,。

class

程序集中的元数据并创建位于该程序集中的类型、类型成员和参数的集合。

因为这些集合支持泛型

与反射配合使用以检索有关与指定搜索条件匹配的方法的特定元数据。

在这种情况下该查询在返回数组等可枚举类型的程序集中查找所有方法的名称。

Assembly

Assembly.Load(System.Private.CoreLib,

Version7.0.0.0,

PublicKeyToken7cec85d7bea7798e);

var

(method.ReturnType.GetInterface(typeof(System.Collections.Generic.IEnumerable).FullName!)

null

groupOfMethods){Console.WriteLine(

{0},

能够在运行时访问泛型类型信息所以可以使用反射获取关于泛型类型的信息方法与用于非泛型类型的方法相同。

IsGenericType

对象的数组这些对象表示为构造类型提供的类型实参或泛型类型定义的类型形参。

GetGenericTypeDefinition返回当前构造类型的基础泛型类型定义。

GetGenericParameterConstraints返回表示当前泛型类型参数约束的

Type

对象的数组。

ContainsGenericParameters如果类型或任何其封闭类型或方法包含未提供特定类型的类型参数则返回

true。

GenericParameterAttributes获取描述当前泛型类型参数的特殊约束的

标志组合。

GenericParameterPosition对于表示类型参数的

Type

对象获取类型参数在声明其类型参数的泛型类型定义或泛型方法定义的类型参数列表中的位置。

IsGenericParameter获取一个值该值指示当前

Type

是否表示泛型类型或方法定义中的类型参数。

IsGenericTypeDefinition获取一个值该值指示当前

Type

true。

DeclaringMethod返回定义当前泛型类型参数的泛型方法如果类型参数未由泛型方法定义则返回

null。

MakeGenericType替代由当前泛型类型定义的类型参数组成的类型数组的元素并返回表示结果构造类型的

Type

true。

GetGenericArguments返回类型对象的数组这些对象表示构造泛型方法的类型实参或泛型方法定义的类型形参。

GetGenericMethodDefinition返回当前构造方法的基础泛型方法定义。

ContainsGenericParameters如果方法或任何其封闭类型包含未提供特定类型的任何类型参数则返回

true。

IsGenericMethodDefinition如果当前

MethodInfo

true。

MakeGenericMethod用类型数组的元素替代当前泛型方法定义的类型参数并返回表示结果构造方法的

MethodInfo