LocalizableAttribute Klasse

Definition

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.Primitives.dll

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

Das nächste Beispiel zeigt, wie der Wert von LocalizableAttribute für MyPropertyüberprüft wird. Zunächst ruft der Code eine PropertyDescriptorCollection mit allen Eigenschaften für das -Objekt ab. Anschließend wird der Code von abgerufen MyPropertyPropertyDescriptorCollection. Als Nächstes gibt es die Attribute für diese Eigenschaft zurück und speichert sie in der Attribute-Variablen.

Schließlich legt der Code auf den Wert von LocalizableAttribute in AttributeCollection festmyAttribute, 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 LocalizableAttribute Satz gekennzeichnet sind, so true dass ihre Eigenschaftswerte in Ressourcendateien gespeichert werden. Sie können diese Ressourcendateien lokalisieren, ohne den Code zu ändern.

Standardmäßig werden bei Elementen, die über kein lokalisierbares Attribut verfügen oder mit dem LocalizableAttribute Satz false auf gekennzeichnet sind, ihre Eigenschaftswerte 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 Wert auf truemarkieren, wird der Wert dieses Attributs auf das konstante Element Yesfestgelegt. Für eine Eigenschaft, die mit festgelegt LocalizableAttribute auf falsegekennzeichnet ist, 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