LocalizableAttribute Classe

Definizione

Spazio dei nomi:

System.ComponentModel

Assembly:

System.ComponentModel.Primitives.dll

Specifica se è necessario localizzare una proprietà o un parametro. La classe non può essere ereditata.

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

Ereditarietà

Object

Attribute

LocalizableAttribute

Attributi

AttributeUsageAttribute

Esempio

Nell'esempio seguente viene contrassegnato il message parametro come deve essere localizzato.

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

Nell'esempio seguente viene contrassegnata una proprietà che deve essere localizzata.

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

Nell'esempio successivo viene illustrato come controllare il valore dell'oggetto LocalizableAttribute per MyProperty. Prima di tutto, il codice ottiene un PropertyDescriptorCollection con tutte le proprietà per l'oggetto. Il codice viene quindi ottenuto MyProperty dall'oggetto PropertyDescriptorCollection. Restituisce quindi gli attributi per questa proprietà e li salva nella variabile attributi.

Infine, il codice imposta myAttribute il valore dell'oggetto LocalizableAttribute in AttributeCollection e verifica se la proprietà deve essere localizzata.

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

Commenti

Quando il codice viene generato per un componente, i membri contrassegnati con il LocalizableAttribute set per true avere i valori delle proprietà salvati nei file di risorse. È possibile localizzare questi file di risorse senza modificare il codice.

Per impostazione predefinita, i membri che non dispongono di attributi localizzabili o sono contrassegnati con il LocalizableAttribute set in modo false che i valori delle proprietà vengano mantenuti nel codice, se il tipo di dati consente. In caso contrario, se il componente principale è impostato su Localizable, tutte le proprietà verranno mantenute nel file di risorse. Il valore predefinito è false.

Nota

Quando si contrassegna una proprietà con l'oggetto LocalizableAttribute impostato su true, il valore di questo attributo è impostato sul membro Yescostante . Per una proprietà contrassegnata con l'oggetto LocalizableAttribute impostato su false, il valore è No. Pertanto, quando si vuole controllare il valore di questo attributo nel codice, è necessario specificare l'attributo come LocalizableAttribute.Yes o LocalizableAttribute.No.

Per altre informazioni, vedere Attributi.

Costruttori

LocalizableAttribute(Boolean)

Inizializza una nuova istanza della classe LocalizableAttribute.

Campi

Default	Consente di specificare il valore predefinito, che è No. Questo campo static è di sola lettura.
No	Specifica che una proprietà non deve essere localizzata. Questo campo static è di sola lettura.
Yes	Specifica che una proprietà deve essere localizzata. Questo campo static è di sola lettura.

Proprietà

IsLocalizable	Ottiene un valore che indica se una proprietà deve essere localizzata.
TypeId	Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)

Metodi

Equals(Object)	Specifica se il valore dell'oggetto specificato è uguale all'oggetto LocalizableAttribute corrente.
GetHashCode()	Restituisce il codice hash per l'istanza.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	Determina se questo attributo è predefinito.
Match(Object)	Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• Attribute
• PropertyDescriptor
• AttributeCollection
• PropertyDescriptorCollection