LocalizableAttribute Classe

Definizione

Spazio dei nomi:

System.ComponentModel

Assembly:

System.ComponentModel.Primitives.dll

Source:

LocalizableAttribute.cs

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

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.

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 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 = 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 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)

Vedi anche

• Attribute
• PropertyDescriptor
• AttributeCollection
• PropertyDescriptorCollection