特性（C# 和 Visual Basic）

特性可以放置在几乎所有的声明中（但特定的特性可能限制在其上有效的声明类型）。 在 C# 中，特性的指定方法为：将括在方括号中的特性名置于其应用到的实体的声明上方。 在 Visual Basic 中，特性括在尖括号 (< >) 内。 它必须位于所应用于的元素的紧前面并与该元素在同一行。

SerializableAttribute attribute is used to apply a specific characteristic to a class:‘ data-guid="8fb3c10d05d42e22f962e6f0583176e9">在本例中，使用特性 SerializableAttribute 将特定特征应用于类：

[System.Serializable]
public class SampleClass
{
    // Objects of this type can be serialized.
}

DllImportAttribute is declared like this:‘ data-guid="b010f6cdc5530c9eb7dec334734b6632">具有 DllImportAttribute 特性的方法的声明如下：

using System.Runtime.InteropServices;


...


[System.Runtime.InteropServices.DllImport("user32.dll")]
extern static void SampleMethod();

一个声明上可放置多个特性：

using System.Runtime.InteropServices;


...


void MethodA([In][Out] ref double x) { }
void MethodB([Out][In] ref double x) { }
void MethodC([In, Out] ref double x) { }

某些特性对于给定实体可以指定多次。 ConditionalAttribute:‘ data-guid="cadbe36606545c5330fa85496c9e51ec">例如，ConditionalAttribute 就是一个可多次使用的特性：

[Conditional("DEBUG"), Conditional("TEST1")]
void TraceMethod()
{
    // ...
}

说明
根据约定，所有特性名称都以单词“Attribute”结束，以便将它们与“.NET Framework”中的其他项区分。 但是，在代码中使用特性时，不需要指定 attribute 后缀。 例如，[DllImport] 虽等效于 [DllImportAttribute]，但 DllImportAttribute 才是该特性在 .NET Framework 中的实际名称。

特性参数

[DllImport("user32.dll")]
[DllImport("user32.dll", SetLastError=false, ExactSpelling=false)]
[DllImport("user32.dll", ExactSpelling=false, SetLastError=false)]

特性目标

target of an attribute is the entity to which the attribute applies.‘ data-guid="7f1c0e86e4db1189cad2c546356dba54">特性的目标是应用该特性的实体。 例如，特性可以应用于类、特定方法或整个程序集。 默认情况下，特性应用于它后面的元素。 但是，您也可以显式标识要将特性应用于方法还是它的参数或返回值。

若要显式标识特性目标，请使用下面的语法：

C#

VB

复制

[target : attribute-list]

target values is shown in the following table.‘ data-guid="7e03263780f8f6ec0a936513fd4469fa">下表显示了可能的 target 值的列表。

 

C#	Visual Basic	适用对象
assembly	Assembly	整个程序集
module	Module	当前程序集模块（不同于 Visual Basic 模块）
field	不支持	在类或结构中的字段
event	不支持	event
method	不支持	get and set property accessors‘ data-guid="9cd8952efbd89ff5c75fd710fd6272dc">方法或 get 和 set 属性访问器
param	不支持	set property accessor parameters‘ data-guid="e9e408739b0cbbd82b396041142c8417">方法参数或 set 属性访问器参数
property	不支持	属性
return	不支持	get property accessor‘ data-guid="2c1d6e68993aa2f67f7b87ec6bab38a5">方法、属性索引器或 get 属性访问器的返回值
type	不支持	结构、类、接口、枚举或委托

下面的示例演示如何将特性应用于程序集和模块。 Common Attributes (C# and Visual Basic).‘ data-guid="6b388e3129c3a598107e46bdd1a2f940">有关更多信息，请参见 常用特性（C# 和 Visual Basic）。

C#

VB

复制

using System;
using System.Reflection;
[assembly: AssemblyTitleAttribute("Production assembly 4")]
[module: CLSCompliant(true)]

下面的示例演示如何在 C# 中将特性应用于方法、方法参数和方法返回值。

C#

复制

// default: applies to method
[SomeAttr]
int Method1() { return 0; }

// applies to method
[method: SomeAttr]
int Method2() { return 0; }

// applies to return value
[return: SomeAttr]
int Method3() { return 0; }

说明

SomeAttr is defined to be valid, the return target has to be specified, even if SomeAttr were defined to apply only to return values.‘ data-guid="a4a672944cece0dd33abb5ea4909f278">无论规定 SomeAttr 应用于什么目标，都必须指定 return 目标，即使 SomeAttr 被定义为仅应用于返回值也是如此。 AttributeUsage information to resolve ambiguous attribute targets.‘ data-guid="f446fd8426e2c7d9fd889842d8561927">换言之，编译器将不使用 AttributeUsage 信息解析不明确的特性目标。 AttributeUsage (C# and Visual Basic).‘ data-guid="acaf7ea147c1d1c7d24ed05c33c8bb3d">有关更多信息，请参见 AttributeUsage（C# 和 Visual Basic）。

以下列表包含特性的几个常见用途：

• WebMethod attribute in Web services to indicate that the method should be callable over the SOAP protocol.‘ data-guid="7c8abe0d8aacd4cceb7dee06329dc403">在 Web 服务中，使用 WebMethod 特性来标记方法，以指示该方法应该可通过 SOAP 协议进行调用。 WebMethodAttribute.‘ data-guid="a021d7ce48001a768c3fe3fd8d410f4e">有关更多信息，请参见 WebMethodAttribute。

• 描述当与本机代码进行交互操作时如何封送方法参数。 MarshalAsAttribute.‘ data-guid="61011a31d362cf22ad1e95ce5dd6b950">有关更多信息，请参见 MarshalAsAttribute。

• 描述类、方法和接口的 COM 属性。

• DllImportAttribute class.‘ data-guid="0811c73d5c2473559338ad453f5d5799">使用 DllImportAttribute 类调用非托管代码。

• 在标题、版本、说明或商标方面描述您的程序集。

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

• 描述如何映射类成员和 XML 节点以便进行 XML 序列化。

• 描述方法的安全要求。

• 指定用于强制安全性的特性。

• 由实时 (JIT) 编译器控制优化，以便易于调试代码。

• 获取有关调用方的信息的方法。

有关更多信息，请参见：

• 创建自定义特性（C# 和 Visual Basic）

• 使用反射访问特性（C# 和 Visual Basic）

• 如何：使用特性创建 C/C++ 联合（C# 和 Visual Basic）

• 常用特性（C# 和 Visual Basic）

• 调用方信息（C# 和 Visual Basic）

参考

概念

其他资源