LocalizableAttribute LocalizableAttribute LocalizableAttribute LocalizableAttribute Class

Определение

Указывает, должно ли быть локализовано свойство.Specifies whether a property should be localized. Этот класс не наследуется.This class cannot be inherited.

public ref class LocalizableAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.All)]
public sealed class LocalizableAttribute : Attribute
type LocalizableAttribute = class
    inherit Attribute
Public NotInheritable Class LocalizableAttribute
Inherits Attribute
Наследование
LocalizableAttributeLocalizableAttributeLocalizableAttributeLocalizableAttribute
Атрибуты

Примеры

В следующем примере свойство отмечается как требующее локализации.The following example marks a property as needing to be localized.

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 для. MyPropertyThe next example shows how to check the value of the LocalizableAttribute for MyProperty. Во- PropertyDescriptorCollection первых, код получает со всеми свойствами для объекта.First, the code gets a PropertyDescriptorCollection with all the properties for the object. Затем код получается MyProperty PropertyDescriptorCollectionиз.Then, the code gets MyProperty from the PropertyDescriptorCollection. Затем он возвращает атрибуты для этого свойства и сохраняет их в переменной attributes.Next, it returns the attributes for this property and saves them in the attributes variable.

Наконец, в коде задается myAttribute значение LocalizableAttribute объекта в AttributeCollection и проверяется, нужно ли локализовать свойство.Finally, the code sets myAttribute to the value of the LocalizableAttribute in the AttributeCollection and checks whether the property needs to be localized.

// 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 набора, должны иметь значения свойств, сохраненные в файлах ресурсов.When code is generated for a component, members that are marked with the LocalizableAttribute set to true have their property values saved in resource files. Эти файлы ресурсов можно локализовать без изменения кода.You can localize these resource files without modifying the code.

По умолчанию элементы, которые не имеют локализуемого атрибута или помечены LocalizableAttribute false атрибутом, будут сохранять значения их свойств в коде, если это разрешено типом данных.By default, members that have no localizable attribute or are marked with the LocalizableAttribute set to false will have their property values persisted to code, if the data type allows. В противном случае, если для Localizableосновного компонента задано значение, все свойства будут сохранены в файле ресурсов.Otherwise, if the main component is set to Localizable, all properties will be persisted to the resource file. Значение по умолчанию — false.The default is false.

Примечание

При пометке свойства с LocalizableAttribute trueпараметром в значение этого атрибута устанавливается равным элементу YesConstant.When you mark a property with the LocalizableAttribute set to true, the value of this attribute is set to the constant member Yes. Для свойства LocalizableAttribute false, помеченного значением, значение равно No.For a property marked with the LocalizableAttribute set to false, the value is No. Поэтому, если необходимо проверить значение этого атрибута в коде, необходимо указать атрибут как LocalizableAttribute.Yes или. LocalizableAttribute.NoTherefore, when you want to check the value of this attribute in your code, you must specify the attribute as LocalizableAttribute.Yes or LocalizableAttribute.No.

Дополнительные сведения см. в разделе Атрибуты.For more information, see Attributes.

Конструкторы

LocalizableAttribute(Boolean) LocalizableAttribute(Boolean) LocalizableAttribute(Boolean) LocalizableAttribute(Boolean)

Инициализирует новый экземпляр класса LocalizableAttribute.Initializes a new instance of the LocalizableAttribute class.

Поля

Default Default Default Default

Определяет значение по умолчанию, которое равно атрибуту No.Specifies the default value, which is No. Это статическое (static) поле доступно только для чтения.This static field is read-only.

No No No No

Определяет, что свойство не должно быть локализовано.Specifies that a property should not be localized. Это статическое (static) поле доступно только для чтения.This static field is read-only.

Yes Yes Yes Yes

Определяет, что свойство должно быть локализовано.Specifies that a property should be localized. Это статическое (static) поле доступно только для чтения.This static field is read-only.

Свойства

IsLocalizable IsLocalizable IsLocalizable IsLocalizable

Возвращает значение, показывающее, должно ли быть локализовано свойство.Gets a value indicating whether a property should be localized.

TypeId TypeId TypeId TypeId

При реализации в производном классе возвращает уникальный идентификатор для этого Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Возвращает значение, показывающее, равно ли значение данного объекта текущему атрибуту LocalizableAttribute.Returns whether the value of the given object is equal to the current LocalizableAttribute.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Возвращает хэш-код данного экземпляра.Returns the hash code for this instance.

GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

Определяет, является ли этот атрибут используемым по умолчанию.Determines if this attribute is the default.

Match(Object) Match(Object) Match(Object) Match(Object)

При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Явные реализации интерфейса

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Возвращает сведения о типе объекта, которые можно использовать для получения сведений о типе интерфейса.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Предоставляет доступ к открытым свойствам и методам объекта.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Применяется к

Дополнительно