LocalizableAttribute 类

定义

命名空间:

System.ComponentModel

程序集:

System.ComponentModel.Primitives.dll

Source:

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

下一个示例演示如何为 检查 的值LocalizableAttributeMyProperty。 首先，代码获取 PropertyDescriptorCollection 具有 对象的所有属性的 。 然后，代码从 PropertyDescriptorCollection获取 MyProperty 。 接下来，它将返回此属性的属性，并将其保存在 attributes 变量中。

最后，代码将 设置为 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 的成员会将其属性值持久保存到代码中（如果数据类型允许）。 否则，如果main组件设置为 Localizable，则所有属性都将保存到资源文件中。 默认为 false。

注意

将 属性LocalizableAttributetrue标记为 时，此属性的值设置为常量成员 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