LocalizableAttribute 類別

定義

命名空間:

System.ComponentModel

組件:

System.ComponentModel.Primitives.dll

來源:

LocalizableAttribute.cs

指定屬性或參數是否應該當地語系化。 此類別無法獲得繼承。

public ref class LocalizableAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.All)]
public sealed class LocalizableAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.All)>]
type LocalizableAttribute = class
    inherit Attribute

Public NotInheritable Class LocalizableAttribute
Inherits Attribute

繼承

Object

Attribute

LocalizableAttribute

屬性

AttributeUsageAttribute

範例

下列範例會將 message 參數標示為需要當地語系化。

public static void ShowMessage([Localizable(true)] string message)

下列範例會將屬性標示為需要當地語系化。

public:
   property int MyProperty 
   {
      [Localizable(true)]
      int get()
      {
         // Insert code here.
         return 0;
      }

      void set( int value )
      {
         // Insert code here.
      }
   }

[Localizable(true)]
 public int MyProperty {
    get {
       // Insert code here.
       return 0;
    }
    set {
       // Insert code here.
    }
 }

<Localizable(True)> _
Public Property MyProperty() As Integer
    Get
        ' Insert code here.
        Return 0
    End Get
    Set
        ' Insert code here.
    End Set 
End Property

下一個範例示範如何檢查 LocalizableAttribute 的值 MyProperty。 首先，程式代碼會取得 PropertyDescriptorCollection 具有物件之所有屬性的 。 然後，程式代碼會從PropertyDescriptorCollection取得MyProperty。 接下來，它會傳回此屬性的屬性，並將其儲存在屬性變數中。

最後，程式代碼會將 設定myAttribute為中的 AttributeCollection 值LocalizableAttribute，並檢查屬性是否需要當地語系化。

// Gets the attributes for the property.
AttributeCollection^ attributes = TypeDescriptor::GetProperties( this )[ "MyProperty" ]->Attributes;

// Checks to see if the property needs to be localized.
LocalizableAttribute^ myAttribute = dynamic_cast<LocalizableAttribute^>(attributes[ LocalizableAttribute::typeid ]);
if ( myAttribute->IsLocalizable )
{
   // Insert code here.
}

// Gets the attributes for the property.
AttributeCollection attributes = 
TypeDescriptor.GetProperties(this)["MyProperty"].Attributes;

// Checks to see if the property needs to be localized.
LocalizableAttribute myAttribute = 
(LocalizableAttribute)attributes[typeof(LocalizableAttribute)];
if(myAttribute.IsLocalizable) {
// Insert code here.
}

' Gets the attributes for the property.
Dim attributes As AttributeCollection = TypeDescriptor.GetProperties(Me)("MyProperty").Attributes

' Checks to see if the property needs to be localized.
Dim myAttribute As LocalizableAttribute = CType(attributes(GetType(LocalizableAttribute)), LocalizableAttribute)
If myAttribute.IsLocalizable Then
     ' Insert code here.
End If

備註

為元件產生程式代碼時，標示 LocalizableAttribute 為的成員會 true 將其屬性值儲存在資源檔中。 您可以本地化這些資源檔，而不需修改程序代碼。

根據預設，沒有可當地語系化屬性或標示 LocalizableAttribute 為 false 的成員，如果數據類型允許，其屬性值會保存至程序代碼。 否則，如果主要元件設定 Localizable為 ，則所有屬性都會保存到資源檔。 預設為 false。

注意

當您將 屬性標示 LocalizableAttribute 為 true時，這個屬性的值會設定為常數成員 Yes。 對於標示為 的屬性，LocalizableAttributefalse此值為 No。 因此，當您要在程式碼中檢查此屬性的值時，您必須將 屬性指定為 LocalizableAttribute.Yes 或 LocalizableAttribute.No。

如需詳細資訊，請參閱屬性。

建構函式

LocalizableAttribute(Boolean)

初始化 LocalizableAttribute 類別的新執行個體。

欄位

Default	指定預設值，即 No。 這個 static 欄位是唯讀的。
No	指定屬性不應該當地語系化。 這個 static 欄位是唯讀的。
Yes	指定屬性應該當地語系化。 這個 static 欄位是唯讀的。

屬性

IsLocalizable	取得值，表示是否應該將屬性當地語系化。
TypeId	在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)

方法

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

另請參閱

• Attribute
• PropertyDescriptor
• AttributeCollection
• PropertyDescriptorCollection