LocalizableAttribute Klasse

Definition

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.Primitives.dll

Quelle:

LocalizableAttribute.cs

Gibt an, ob eine Eigenschaft oder ein Parameter lokalisiert werden soll. Diese Klasse kann nicht vererbt werden.

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

Vererbung

Object

Attribute

LocalizableAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Beispiel wird der message Parameter als lokalisiert markiert.

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

Im folgenden Beispiel wird eine Eigenschaft als lokalisiert markiert.

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

Im nächsten Beispiel wird gezeigt, wie der Wert von für MyPropertyüberprüft wirdLocalizableAttribute. Zunächst ruft der Code einen PropertyDescriptorCollection mit allen Eigenschaften für das -Objekt ab. Anschließend wird der Code von abgerufen MyPropertyPropertyDescriptorCollection. Als Nächstes werden die Attribute für diese Eigenschaft zurückgegeben und in der Variablen attributes gespeichert.

Schließlich legt myAttribute der Code auf den Wert von LocalizableAttribute in fest AttributeCollection und überprüft, ob die Eigenschaft lokalisiert werden muss.

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

Hinweise

Wenn Code für eine Komponente generiert wird, werden Elemente, die mit dem -Element markiert sind, LocalizableAttribute so gekennzeichnet, dass true ihre Eigenschaftswerte in Ressourcendateien gespeichert werden. Sie können diese Ressourcendateien lokalisieren, ohne den Code zu ändern.

Standardmäßig werden die Eigenschaftswerte von Membern, die kein lokalisierbares Attribut besitzen oder mit dem LocalizableAttribute -Wert gekennzeichnet false sind, im Code beibehalten, sofern der Datentyp dies zulässt. Andernfalls werden alle Eigenschaften in der Ressourcendatei beibehalten, wenn die komponente Standard auf Localizablefestgelegt ist. Der Standardwert lautet false.

Hinweis

Wenn Sie eine Eigenschaft mit dem LocalizableAttribute festlegen true, wird der Wert dieses Attributs auf den konstanten Member Yesfestgelegt. Für eine Eigenschaft, die LocalizableAttribute mit auf gekennzeichnet falseist, ist Noder Wert . Wenn Sie daher den Wert dieses Attributs in Ihrem Code überprüfen möchten, müssen Sie das Attribut als LocalizableAttribute.Yes oder LocalizableAttribute.Noangeben.

Weitere Informationen finden Sie unter Attribute.

Konstruktoren

LocalizableAttribute(Boolean)

Initialisiert eine neue Instanz der LocalizableAttribute-Klasse.

Felder

Default	Gibt den Standardwert an, der No ist. Dieses static-Feld ist schreibgeschützt.
No	Gibt an, dass eine Eigenschaft nicht lokalisiert werden soll. Dieses static-Feld ist schreibgeschützt.
Yes	Gibt an, dass eine Eigenschaft lokalisiert werden soll. Dieses static-Feld ist schreibgeschützt.

Eigenschaften

IsLocalizable	Ruft einen Wert ab, der angibt, ob eine Eigenschaft lokalisiert werden soll.
TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)

Methoden

Equals(Object)	Gibt zurück, ob der Wert des angegebenen Objekts gleich dem aktuellen LocalizableAttribute ist.
GetHashCode()	Gibt den Hashcode für diese Instanz zurück.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Bestimmt, ob dieses Attribut der Standardwert ist.
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• Attribute
• PropertyDescriptor
• AttributeCollection
• PropertyDescriptorCollection