MergablePropertyAttribute Clase

Definición

Espacio de nombres:

System.ComponentModel

Ensamblado:

System.ComponentModel.Primitives.dll

Source:

MergablePropertyAttribute.cs

Especifica que esta propiedad puede combinarse en una ventana Propiedades con otras propiedades pertenecientes a otros objetos.

public ref class MergablePropertyAttribute sealed : Attribute

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

[<System.AttributeUsage(System.AttributeTargets.All)>]
type MergablePropertyAttribute = class
    inherit Attribute

Public NotInheritable Class MergablePropertyAttribute
Inherits Attribute

Herencia

Object

Attribute

MergablePropertyAttribute

Atributos

AttributeUsageAttribute

Ejemplos

En el ejemplo siguiente se marca una propiedad según corresponda para combinar.

public:
   [MergableProperty(true)]
   property int MyProperty 
   {
      int get()
      {
         // Insert code here.
         return 0;
      }
      void set( int value )
      {
         // Insert code here.
      }
   }

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

<MergableProperty(True)> _
Public Property MyProperty() As Integer
    Get
        ' Insert code here.
        Return 0
    End Get
    Set
        ' Insert code here.
    End Set 
End Property

En el ejemplo siguiente se muestra cómo comprobar el valor de para MergablePropertyAttributeMyProperty. En primer lugar, el código obtiene con PropertyDescriptorCollection todas las propiedades del objeto . A continuación, se indexa en para PropertyDescriptorCollection obtener MyProperty. A continuación, devuelve los atributos de esta propiedad y los guarda en la variable attributes.

En el ejemplo se presentan dos formas diferentes de comprobar el valor de MergablePropertyAttribute. En el segundo fragmento de código, el ejemplo llama al Equals método con un static valor . En el último fragmento de código, en el ejemplo se usa la AllowMerge propiedad para comprobar el valor.

// Gets the attributes for the property.
AttributeCollection^ attributes = TypeDescriptor::GetProperties( this )[ "MyProperty" ]->Attributes;

// Checks to see if the value of the MergablePropertyAttribute is Yes.
if ( attributes[ MergablePropertyAttribute::typeid ]->Equals( MergablePropertyAttribute::Yes ) )
{
   // Insert code here.
}

// This is another way to see if the property is bindable.
MergablePropertyAttribute^ myAttribute = dynamic_cast<MergablePropertyAttribute^>(attributes[ MergablePropertyAttribute::typeid ]);
if ( myAttribute->AllowMerge )
{
   // Insert code here.
}

// Gets the attributes for the property.
 AttributeCollection attributes = 
    TypeDescriptor.GetProperties(this)["MyProperty"].Attributes;
 
 // Checks to see if the value of the MergablePropertyAttribute is Yes.
 if(attributes[typeof(MergablePropertyAttribute)].Equals(MergablePropertyAttribute.Yes)) {
    // Insert code here.
 }
 
 // This is another way to see if the property is bindable.
 MergablePropertyAttribute myAttribute = 
    (MergablePropertyAttribute)attributes[typeof(MergablePropertyAttribute)];
 if(myAttribute.AllowMerge) {
    // Insert code here.
 }

' Gets the attributes for the property.
Dim attributes As AttributeCollection = _
    TypeDescriptor.GetProperties(Me)("MyProperty").Attributes

' Checks to see if the value of the MergablePropertyAttribute is Yes.
If attributes(GetType(MergablePropertyAttribute)).Equals(MergablePropertyAttribute.Yes) Then
    ' Insert code here.
End If 

' This is another way to see if the property is bindable.
Dim myAttribute As MergablePropertyAttribute = _
    CType(attributes(GetType(MergablePropertyAttribute)), MergablePropertyAttribute)
If myAttribute.AllowMerge Then
    ' Insert code here.
End If

Si marcó una clase con MergablePropertyAttribute, use el código siguiente para comprobar el valor.

AttributeCollection^ attributes = TypeDescriptor::GetAttributes( MyProperty );
if ( attributes[ MergablePropertyAttribute::typeid ]->Equals( MergablePropertyAttribute::Yes ) )
{
   // Insert code here.
}

AttributeCollection attributes = 
    TypeDescriptor.GetAttributes(MyProperty);
 if(attributes[typeof(MergablePropertyAttribute)].Equals(MergablePropertyAttribute.Yes)) {
    // Insert code here.
 }

Dim attributes As AttributeCollection = TypeDescriptor.GetAttributes(MyProperty)
If attributes(GetType(MergablePropertyAttribute)).Equals(MergablePropertyAttribute.Yes) Then
    ' Insert code here.
End If

Comentarios

Las propiedades marcadas con el MergablePropertyAttribute conjunto en true se pueden combinar con propiedades que pertenecen a otros objetos de un ventana Propiedades. Las propiedades marcadas con el MergablePropertyAttribute conjunto en false deben mostrarse por separado. El valor predeterminado es true.

Nota

Al marcar una propiedad con el MergablePropertyAttribute establecido trueen , el valor de este atributo se establece en el miembro Yesconstante . Para una propiedad marcada con la MergablePropertyAttribute propiedad establecida falseen , el valor es No. Por lo tanto, cuando desee comprobar el valor de este atributo en el código, debe especificar el atributo como MergablePropertyAttribute.Yes o MergablePropertyAttribute.No.

Para obtener más información, consulte Attributes (Atributos).

Constructores

MergablePropertyAttribute(Boolean)

Inicializa una nueva instancia de la clase MergablePropertyAttribute.

Campos

Default	Especifica el valor predeterminado, que es Yes. Esta propiedad se puede combinar con propiedades que pertenecen a otros objetos en una ventana Propiedades. Este campo static es de solo lectura.
No	Especifica que una propiedad no puede combinarse en una ventana Propiedades con otras propiedades pertenecientes a otros objetos. Este campo static es de solo lectura.
Yes	Especifica que una propiedad puede combinarse en una ventana Propiedades con otras propiedades pertenecientes a otros objetos. Este campo static es de solo lectura.

Propiedades

AllowMerge	Obtiene un valor que indica si esta propiedad puede combinarse en una ventana Propiedades con propiedades pertenecientes a otros objetos.
TypeId	Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. (Heredado de Attribute)

Métodos

Equals(Object)	Indica si esta instancia y un objeto especificado son iguales.
GetHashCode()	Devuelve el código hash de esta instancia.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IsDefaultAttribute()	Determina si este atributo es el valor predeterminado.
Match(Object)	Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. (Heredado de Attribute)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• PropertyDescriptor
• AttributeCollection
• PropertyDescriptorCollection
• Attribute