LocalizableAttribute Class

Definición

Especifica si se debería localizar una propiedad. Specifies whether a property should be localized. Esta clase no puede heredarse. This class cannot be inherited.

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

Ejemplos

El ejemplo siguiente marca una propiedad indicación de que se va a localizar.The following example marks a property as needing to be localized.

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

El ejemplo siguiente muestra cómo comprobar el valor de la LocalizableAttribute para MyProperty.The next example shows how to check the value of the LocalizableAttribute for MyProperty. En primer lugar, el código obtiene una PropertyDescriptorCollection con todas las propiedades del objeto.First, the code gets a PropertyDescriptorCollection with all the properties for the object. A continuación, el código obtiene MyProperty desde el PropertyDescriptorCollection.Then, the code gets MyProperty from the PropertyDescriptorCollection. A continuación, devuelve los atributos de esta propiedad y los guarda en la variable de atributos.Next, it returns the attributes for this property and saves them in the attributes variable.

Por último, el código establece myAttribute al valor de la LocalizableAttribute en el AttributeCollection y comprueba si la propiedad se debe localizar.Finally, the code sets myAttribute to the value of the LocalizableAttribute in the AttributeCollection and checks whether the property needs to be localized.

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

Comentarios

Cuando se genera código para un componente, los miembros marcados con el LocalizableAttribute establecido en true tienen sus valores de propiedad que se guardan en archivos de recursos.When code is generated for a component, members that are marked with the LocalizableAttribute set to true have their property values saved in resource files. Puede localizar estos archivos de recursos sin modificar el código.You can localize these resource files without modifying the code.

De forma predeterminada, los miembros que no tienen ningún atributo localizable o se marcan con el LocalizableAttribute establecido en false tendrán sus valores de propiedad persisten en el código si se permite el tipo de datos.By default, members that have no localizable attribute or are marked with the LocalizableAttribute set to false will have their property values persisted to code, if the data type allows. En caso contrario, si el componente principal se establece en Localizable, todas las propiedades se conservará en el archivo de recursos.Otherwise, if the main component is set to Localizable, all properties will be persisted to the resource file. El valor predeterminado es false.The default is false.

Nota

Cuando se marca una propiedad con el LocalizableAttribute establecido en true, el valor de este atributo se establece en el miembro constante Yes.When you mark a property with the LocalizableAttribute set to true, the value of this attribute is set to the constant member Yes. Para una propiedad marcada con el LocalizableAttribute establecido en false, el valor es No.For a property marked with the LocalizableAttribute set to false, the value is No. Por lo tanto, cuando desee comprobar el valor de este atributo en el código, debe especificar el atributo como LocalizableAttribute.Yes o LocalizableAttribute.No.Therefore, when you want to check the value of this attribute in your code, you must specify the attribute as LocalizableAttribute.Yes or LocalizableAttribute.No.

Para obtener más información, consulte Attributes (Atributos).For more information, see Attributes.

Constructores

LocalizableAttribute(Boolean)

Inicializa una nueva instancia de la clase LocalizableAttribute. Initializes a new instance of the LocalizableAttribute class.

Campos

Default

Especifica el valor predeterminado, que es No. Specifies the default value, which is No. Este campo static es de solo lectura. This static field is read-only.

No

Especifica que no se debe traducir una propiedad. Specifies that a property should not be localized. Este campo static es de solo lectura. This static field is read-only.

Yes

Especifica que se debe traducir una propiedad. Specifies that a property should be localized. Este campo static es de solo lectura. This static field is read-only.

Propiedades

IsLocalizable

Obtiene un valor que indica si una propiedad se debe traducir. Gets a value indicating whether a property should be localized.

TypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Métodos

Equals(Object)

Devuelve un valor que indica si el valor del objeto especificado es igual al atributo LocalizableAttribute actual. Returns whether the value of the given object is equal to the current LocalizableAttribute.

GetHashCode()

Devuelve el código hash de esta instancia. Returns the hash code for this instance.

GetType()

Obtiene el Type de la instancia actual. Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute()

Determina si este atributo es el valor predeterminado. Determines if this attribute is the default.

Match(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone()

Crea una copia superficial del Object actual. Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Devuelve una cadena que representa el objeto actual. Returns a string that represents the current object.

(Inherited from Object)

Implementaciones de interfaz explícitas

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío. Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz. Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1). Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acceso a las propiedades y los métodos expuestos por un objeto. Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Se aplica a

Consultar también