LocalizableAttribute 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
指定是否应本地化属性或参数。 此类不能被继承。
public ref class LocalizableAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.All)]
public sealed class LocalizableAttribute : Attribute
public sealed class LocalizableAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.All)>]
type LocalizableAttribute = class
inherit Attribute
type LocalizableAttribute = class
inherit Attribute
Public NotInheritable Class LocalizableAttribute
Inherits Attribute
- 继承
- 属性
示例
以下示例将 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。 此 |
No |
指定属性不应本地化。 此 |
Yes |
指定属性应本地化。 此 |
属性
IsLocalizable |
获取一个值,该值指示属性是否应本地化。 |
TypeId |
在派生类中实现时,获取此 Attribute 的唯一标识符。 (继承自 Attribute) |
方法
Equals(Object) |
返回给定对象的值是否等于当前的 LocalizableAttribute。 |
GetHashCode() |
返回此实例的哈希代码。 |
GetType() |
获取当前实例的 Type。 (继承自 Object) |
IsDefaultAttribute() |
确定此特性是否为默认特性。 |
IsDefaultAttribute() |
在派生类中重写时,指示此实例的值是否是派生类的默认值。 (继承自 Attribute) |
Match(Object) |
当在派生类中重写时,返回一个指示此实例是否等于指定对象的值。 (继承自 Attribute) |
MemberwiseClone() |
创建当前 Object 的浅表副本。 (继承自 Object) |
ToString() |
返回表示当前对象的字符串。 (继承自 Object) |
显式接口实现
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
将一组名称映射为对应的一组调度标识符。 (继承自 Attribute) |
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
检索对象的类型信息,然后可以使用该信息获取接口的类型信息。 (继承自 Attribute) |
_Attribute.GetTypeInfoCount(UInt32) |
检索对象提供的类型信息接口的数量(0 或 1)。 (继承自 Attribute) |
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
提供对某一对象公开的属性和方法的访问。 (继承自 Attribute) |