AttributeUsageAttribute 類別

定義

命名空間:

System

組件:

System.Runtime.dll

組件:

mscorlib.dll

組件:

netstandard.dll

指定另一個屬性類別的使用方式。 此類別無法獲得繼承。

C#

[System.AttributeUsage(System.AttributeTargets.Class, Inherited=true)]
public sealed class AttributeUsageAttribute : Attribute

C#

[System.AttributeUsage(System.AttributeTargets.Class, Inherited=true)]
[System.Serializable]
public sealed class AttributeUsageAttribute : Attribute

C#

[System.AttributeUsage(System.AttributeTargets.Class, Inherited=true)]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class AttributeUsageAttribute : Attribute

繼承

Object

Attribute

AttributeUsageAttribute

屬性

AttributeUsageAttribute SerializableAttribute ComVisibleAttribute

備註

當您定義自己的屬性類別時，您可以藉由將 放在 AttributeUsageAttribute 您的屬性類別上來控制其使用方式。 指定的屬性類別必須直接或間接衍生自 Attribute 。

屬性類別具有位置和具名參數。 屬性類別的每個公用建構函式都會定義該類別的有效位置參數序列。 具名參數是由屬性類別的非靜態、公用和讀寫欄位或屬性所定義。

的三個屬性 AttributeUsageAttribute 是藉由定義下列參數來設定：

• ValidOn

這個位置參數會指定可放置指定屬性的程式專案。 您可以放置屬性的所有可能元素集合都會列在 列舉中 AttributeTargets 。 您可以使用位 OR 運算結合數 AttributeTargets 個值，以取得有效的程式專案所需的組合。

• AllowMultiple

這個具名參數會指定指定的程式專案是否可以多次指定指定的屬性。

• Inherited

這個具名參數會指定衍生類別和覆寫成員是否可以繼承指定的屬性。

如需使用屬性的詳細資訊，請參閱 Attribute 和 屬性。

建構函式

AttributeUsageAttribute(AttributeTargets)

使用指定的 AttributeUsageAttribute 清單、AttributeTargets 值和 AllowMultiple 值，初始化 Inherited 類別的新執行個體。

屬性

AllowMultiple	取得或設定布林值 (Boolean)，指出所指定屬性的幾個執行個體能否指定給單一程式項目。
Inherited	取得或設定 Boolean 值，判斷指示的屬性是否由衍伸類別繼承並覆寫成員。
TypeId	在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)
ValidOn	取得一組數值，辨識哪些程式項目可套用所指定的屬性。

方法

Equals(Object)	傳回值，這個值指出此執行個體是否與指定的物件相等。 (繼承來源 Attribute)
GetHashCode()	傳回這個執行個體的雜湊碼。 (繼承來源 Attribute)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsDefaultAttribute()	在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。 (繼承來源 Attribute)
Match(Object)	在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承來源 Attribute)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。 (繼承來源 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	擷取物件的類型資訊，可以用來取得介面的類型資訊。 (繼承來源 Attribute)
_Attribute.GetTypeInfoCount(UInt32)	擷取物件提供的類型資訊介面數目 (0 或 1)。 (繼承來源 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	提供物件所公開的屬性和方法的存取權。 (繼承來源 Attribute)

適用於

另請參閱

• Attribute
• AttributeTargets
• 使用屬性擴充中繼資料