LocalizableAttribute Klasa

Definicja

Przestrzeń nazw:
System.ComponentModel
Zestaw:
System.dll
Zestaw:
netstandard.dll

Określa, czy właściwość lub parametr powinny być zlokalizowane. Klasa ta nie może być dziedziczona.

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
Dziedziczenie
Object
Attribute
LocalizableAttribute
Atrybuty
AttributeUsageAttribute

Przykłady

W poniższym przykładzie parametr jest message oznaczany jako konieczne zlokalizowanie.

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

W poniższym przykładzie właściwość jest oznaczona jako konieczna lokalizacja.

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.
        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 elementu dla MyProperty. Najpierw kod pobiera PropertyDescriptorCollection obiekt ze wszystkimi właściwościami obiektu. Następnie kod pobiera się MyProperty z pliku PropertyDescriptorCollection. Następnie zwraca atrybuty tej właściwości i zapisuje je w zmiennej atrybutów.

Na koniec kod ustawia myAttribute wartość LocalizableAttribute elementu w AttributeCollection obiekcie i sprawdza, czy właściwość musi być zlokalizowana.

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

Gdy kod jest generowany dla składnika, elementy członkowskie oznaczone zestawem LocalizableAttribute mają true wartości właściwości zapisane w plikach zasobów. Te pliki zasobów można lokalizować bez modyfikowania kodu.

Domyślnie elementy członkowskie, które nie mają atrybutu lokalizowalnego lub są oznaczone za pomocą LocalizableAttribute zestawu , false będą miały ich wartości właściwości utrwalone w kodzie, jeśli typ danych zezwala. W przeciwnym razie, jeśli główny składnik jest ustawiony na Localizablewartość , wszystkie właściwości zostaną utrwalone w pliku zasobu. Wartość domyślna to false.

Note

Gdy oznaczysz właściwość z LocalizableAttribute ustawioną wartością true, wartość tego atrybutu jest ustawiona na stały element członkowski Yes. Dla właściwości oznaczonej wartością ustawioną LocalizableAttribute na false, wartość to 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.

Aby uzyskać więcej informacji, zobacz Atrybuty.

Konstruktory

Nazwa Opis
LocalizableAttribute(Boolean)

Inicjuje nowe wystąpienie klasy LocalizableAttribute.

Pola

Nazwa Opis
Default

Określa wartość domyślną, czyli No. To static pole jest tylko do odczytu.
No

Określa, że właściwość nie powinna być zlokalizowana. To static pole jest tylko do odczytu.
Yes

Określa, że właściwość powinna być zlokalizowana. To static pole jest tylko do odczytu.

Właściwości

Nazwa Opis
IsLocalizable

Pobiera wartość wskazującą, czy właściwość powinna być zlokalizowana.
TypeId

Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attribute.

(Odziedziczone po Attribute)

Metody

Nazwa Opis
Equals(Object)

Zwraca, czy wartość danego obiektu jest równa bieżącej LocalizableAttributewartości .
GetHashCode()

Zwraca kod skrótu dla tego wystąpienia.
GetType()

Pobiera Type bieżącego wystąpienia.

(Odziedziczone po Object)
IsDefaultAttribute()

Określa, czy ten atrybut jest domyślny.
Match(Object)

Po zastąpieniu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi.

(Odziedziczone po Attribute)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Object.

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Jawne implementacje interfejsu

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

Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania.

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

Pobiera informacje o typie obiektu, którego można użyć do uzyskania informacji o typie dla interfejsu.

(Odziedziczone po Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1).

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

Zapewnia dostęp do właściwości i metod uwidocznionych przez obiekt.

(Odziedziczone po Attribute)

Dotyczy

Zobacz też