LocalizableAttribute Classe

Définition

Espace de noms:: System.ComponentModel

Assembly:: System.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Spécifie si une propriété ou un paramètre doit être localisé. Cette classe ne peut pas être héritée.

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

Héritage: Object

Attribute
LocalizableAttribute

Attributs: AttributeUsageAttribute

Exemples

L’exemple suivant marque le message paramètre comme nécessitant une localisation.

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

L’exemple suivant marque une propriété comme nécessitant une localisation.

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

L’exemple suivant montre comment vérifier la valeur de la LocalizableAttribute valeur pour MyProperty. Tout d’abord, le code obtient une PropertyDescriptorCollection valeur avec toutes les propriétés de l’objet. Ensuite, le code est extrait MyProperty du PropertyDescriptorCollection. Ensuite, elle retourne les attributs de cette propriété et les enregistre dans la variable d’attributs.

Enfin, le code définit myAttribute la valeur du LocalizableAttribute dans le AttributeCollection code et vérifie si la propriété doit être localisée.

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

Remarques

Lorsque le code est généré pour un composant, les membres marqués avec l’ensemble LocalizableAttribute doivent true enregistrer leurs valeurs de propriété dans les fichiers de ressources. Vous pouvez localiser ces fichiers de ressources sans modifier le code.

Par défaut, les membres qui n’ont pas d’attribut localisable ou qui sont marqués avec l’ensemble LocalizableAttribute pour false que leurs valeurs de propriété soient conservées dans le code, si le type de données autorise. Sinon, si le composant principal est défini Localizablesur , toutes les propriétés sont conservées dans le fichier de ressources. La valeur par défaut est false.

Note

Lorsque vous marquez une propriété avec la LocalizableAttributetruevaleur définie sur , la valeur de cet attribut est définie sur le membre Yesconstant . Pour une propriété marquée avec la LocalizableAttribute valeur définie false, la valeur est No. Par conséquent, lorsque vous souhaitez vérifier la valeur de cet attribut dans votre code, vous devez spécifier l’attribut en tant que LocalizableAttribute.Yes ou LocalizableAttribute.No.

Pour plus d’informations, consultez Attributs.

Constructeurs

Nom	Description
LocalizableAttribute(Boolean)	Initialise une nouvelle instance de la classe LocalizableAttribute.

Champs

Nom	Description
Default	Spécifie la valeur par défaut, qui est No. Ce `static` champ est en lecture seule.
No	Spécifie qu’une propriété ne doit pas être localisée. Ce `static` champ est en lecture seule.
Yes	Spécifie qu’une propriété doit être localisée. Ce `static` champ est en lecture seule.

Propriétés

Nom	Description
IsLocalizable	Obtient une valeur indiquant si une propriété doit être localisée.
TypeId	En cas d’implémentation dans une classe dérivée, obtient un identificateur unique pour cette Attribute. (Hérité de Attribute)

Méthodes

Nom	Description
Equals(Object)	Retourne si la valeur de l’objet donné est égale à la valeur actuelle LocalizableAttribute.
GetHashCode()	Retourne le code de hachage pour cette instance.
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
IsDefaultAttribute()	Détermine si cet attribut est la valeur par défaut.
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur qui indique si cette instance est égale à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

Nom	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch. (Hérité de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Récupère les informations de type d’un objet, qui peuvent être utilisées pour obtenir les informations de type d’une interface. (Hérité de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1). (Hérité de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fournit l’accès aux propriétés et méthodes exposées par un objet. (Hérité de Attribute)

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?