LocalizableAttribute Classe

Definizione

Spazio dei nomi:

System.ComponentModel

Assembly:

System.ComponentModel.Primitives.dll

Origine:

LocalizableAttribute.cs

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

[System.AttributeUsage(System.AttributeTargets.All)]
public sealed class LocalizableAttribute : Attribute

Ereditarietà

Object

Attribute

LocalizableAttribute

Attributi

AttributeUsageAttribute

Esempio

L'esempio seguente contrassegna il message parametro come necessario per essere localizzato.

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

L'esempio seguente contrassegna una proprietà come necessario per essere localizzata.

[Localizable(true)]
 public int MyProperty {
    get {
       // Insert code here.
       return 0;
    }
    set {
       // Insert code here.
    }
 }

Nell'esempio seguente viene illustrato come controllare il valore di LocalizableAttribute per MyProperty. Innanzitutto, il codice ottiene un PropertyDescriptorCollection oggetto con tutte le proprietà per l'oggetto . Il codice ottiene MyProperty quindi da PropertyDescriptorCollection. Restituisce quindi gli attributi per questa proprietà e li salva nella variabile degli attributi.

Infine, il codice imposta myAttribute sul valore di LocalizableAttribute in AttributeCollection e controlla 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 = 
(LocalizableAttribute)attributes[typeof(LocalizableAttribute)];
if(myAttribute.IsLocalizable) {
// Insert code here.
}

Commenti

Quando viene generato il codice per un componente, i membri contrassegnati con il LocalizableAttribute set in modo true da salvare i valori delle proprietà 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 su false avranno i valori delle proprietà persistenti nel codice, se il tipo di dati consente. In caso contrario, se il componente principale è impostato su Localizable, tutte le proprietà verranno rese persistenti 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 viene 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)

Si applica a

Vedi anche

• Attribute
• PropertyDescriptor
• AttributeCollection
• PropertyDescriptorCollection