LocalizableAttribute Klasa

Definicja

Określa, czy właściwość lub parametr ma być zlokalizowany.Specifies whether a property or parameter should be localized. Klasa ta nie może być dziedziczona.This class cannot be inherited.

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
Dziedziczenie
LocalizableAttribute
Atrybuty

Przykłady

Poniższy przykład oznacza, że message parametr musi być zlokalizowany.The following example marks the message parameter as needing to be localized.

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

Poniższy przykład oznacza właściwość jako wymaganą do zlokalizowania.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

W następnym przykładzie pokazano, jak sprawdzić wartość LocalizableAttribute dla MyProperty .The next example shows how to check the value of the LocalizableAttribute for MyProperty. Najpierw kod pobiera PropertyDescriptorCollection wszystkie właściwości obiektu.First, the code gets a PropertyDescriptorCollection with all the properties for the object. Następnie kod otrzymuje MyProperty od PropertyDescriptorCollection .Then, the code gets MyProperty from the PropertyDescriptorCollection. Następnie zwraca atrybuty dla tej właściwości i zapisuje je w zmiennej atrybutów.Next, it returns the attributes for this property and saves them in the attributes variable.

Na koniec kod jest ustawiany myAttribute na wartość LocalizableAttribute w AttributeCollection i sprawdza, czy właściwość musi być zlokalizowana.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

Uwagi

Po wygenerowaniu kodu dla składnika elementy członkowskie oznaczone LocalizableAttribute zestawem mają true mieć wartości właściwości zapisane w plikach zasobów.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. Te pliki zasobów można zlokalizować bez modyfikowania kodu.You can localize these resource files without modifying the code.

Domyślnie elementy członkowskie, które nie mają lokalizowalnych atrybutów lub są oznaczone LocalizableAttribute zestawem do false , będą miały wartości właściwości utrwalone dla kodu, jeśli typ danych zezwala.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. W przeciwnym razie, jeśli główny składnik jest ustawiony na Localizable , wszystkie właściwości zostaną utrwalone w pliku zasobów.Otherwise, if the main component is set to Localizable, all properties will be persisted to the resource file. Wartość domyślna to false.The default is false.

Uwaga

Po oznaczeniu właściwości LocalizableAttribute zestawem do true , wartość tego atrybutu jest ustawiana na stałą składową Yes .When you mark a property with the LocalizableAttribute set to true, the value of this attribute is set to the constant member Yes. Dla właściwości oznaczonej LocalizableAttribute ustawieniem na false , wartość jest No .For a property marked with the LocalizableAttribute set to false, the value is No. W związku z tym, jeśli chcesz sprawdzić wartość tego atrybutu w kodzie, musisz określić atrybut jako LocalizableAttribute.Yes lub LocalizableAttribute.No .Therefore, when you want to check the value of this attribute in your code, you must specify the attribute as LocalizableAttribute.Yes or LocalizableAttribute.No.

Aby uzyskać więcej informacji, zobacz atrybuty.For more information, see Attributes.

Konstruktory

LocalizableAttribute(Boolean)

Inicjuje nowe wystąpienie klasy LocalizableAttribute.Initializes a new instance of the LocalizableAttribute class.

Pola

Default

Określa wartość domyślną No .Specifies the default value, which is No. To static pole jest tylko do odczytu.This static field is read-only.

No

Określa, że właściwość nie powinna być zlokalizowana.Specifies that a property should not be localized. To static pole jest tylko do odczytu.This static field is read-only.

Yes

Określa, że właściwość powinna być zlokalizowana.Specifies that a property should be localized. To static pole jest tylko do odczytu.This static field is read-only.

Właściwości

IsLocalizable

Pobiera wartość wskazującą, czy właściwość powinna być zlokalizowana.Gets a value indicating whether a property should be localized.

TypeId

Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego elementu Attribute .When implemented in a derived class, gets a unique identifier for this Attribute.

(Odziedziczone po Attribute)

Metody

Equals(Object)

Zwraca czy wartość danego obiektu jest równa bieżącemu LocalizableAttribute .Returns whether the value of the given object is equal to the current LocalizableAttribute.

GetHashCode()

Zwraca wartość skrótu dla tego wystąpienia.Returns the hash code for this instance.

GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
IsDefaultAttribute()

Określa, czy ten atrybut jest wartością domyślną.Determines if this attribute is the default.

IsDefaultAttribute()

Gdy jest zastępowany w klasie pochodnej, wskazuje, czy wartość tego wystąpienia jest wartością domyślną klasy pochodnej.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Odziedziczone po Attribute)
Match(Object)

Gdy jest zastępowany w klasie pochodnej, zwraca wartość wskazującą, czy to wystąpienie jest zgodne z określonym obiektem.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Odziedziczone po Attribute)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Jawne implementacje interfejsu

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

Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania.Maps a set of names to a corresponding set of dispatch identifiers.

(Odziedziczone po Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Pobiera informacje o typie dla obiektu, którego można użyć do uzyskania informacji o typie dla interfejsu.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Odziedziczone po Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Odziedziczone po Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Umożliwia dostęp do właściwości i metod udostępnianych przez obiekt.Provides access to properties and methods exposed by an object.

(Odziedziczone po Attribute)

Dotyczy

Zobacz też