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

В следующем примере показано, как проверка значение для LocalizableAttributeMyProperty. Во-первых, код получает со PropertyDescriptorCollection всеми свойствами объекта . Затем код получает из MyPropertyPropertyDescriptorCollection. Затем он возвращает атрибуты для этого свойства и сохраняет их в переменной атрибутов.

Наконец, код задает myAttribute значение LocalizableAttribute в AttributeCollection и проверяет, нужно ли локализовать свойство.

// 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

Комментарии

При создании кода для компонента элементы, помеченные набором LocalizableAttributetrue , сохраняют значения свойств в файлах ресурсов. Эти файлы ресурсов можно локализовать, не изменяя код.

По умолчанию значения свойств элементов, не имеющих локализуемого атрибута или помеченных как LocalizableAttributefalse , сохраняются в коде, если это позволяет тип данных. В противном случае, если компонент 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