MergablePropertyAttribute Classe

Definição

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.Primitives.dll

Origem:

MergablePropertyAttribute.cs

Especifica que esta propriedade pode ser combinada com propriedades que pertencem a outros objetos em uma janela Propriedades.

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

Herança

Object

Attribute

MergablePropertyAttribute

Atributos

AttributeUsageAttribute

Exemplos

O exemplo a seguir marca uma propriedade conforme apropriado para mesclar.

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

O exemplo a seguir mostra como marcar o valor do MergablePropertyAttribute para MyProperty. Primeiro, o código obtém um PropertyDescriptorCollection com todas as propriedades do objeto . Em seguida, ele indexa para o PropertyDescriptorCollection para obter MyProperty. Em seguida, retorna os atributos dessa propriedade e os salva na variável de atributos.

O exemplo apresenta duas maneiras diferentes de verificar o valor do MergablePropertyAttribute. No segundo fragmento de código, o exemplo chama o Equals método com um static valor . No último fragmento de código, o exemplo usa a AllowMerge propriedade para marcar o 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

Se você marcou uma classe com o MergablePropertyAttribute, use o código a seguir para marcar o 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

Comentários

As propriedades marcadas com o MergablePropertyAttribute definido como true podem ser combinadas com propriedades pertencentes a outros objetos em um janela Propriedades. As propriedades marcadas com o MergablePropertyAttribute conjunto como false devem ser exibidas separadamente. O padrão é true.

Observação

Quando você marca uma propriedade com o MergablePropertyAttribute definido como true, o valor desse atributo é definido como o membro Yesconstante . Para uma propriedade marcada com a MergablePropertyAttribute propriedade definida como false, o valor é No. Portanto, quando você deseja marcar o valor desse atributo em seu código, você deve especificar o atributo como MergablePropertyAttribute.Yes ou MergablePropertyAttribute.No.

Para obter mais informações, consulte Atributos.

Construtores

MergablePropertyAttribute(Boolean)

Inicializa uma nova instância da classe MergablePropertyAttribute.

Campos

Default	Especifica o valor padrão, que é Yes, que é uma propriedade que pode ser combinada a propriedades que pertencem a outros objetos em uma janela Propriedades. Esse campo static é somente leitura.
No	Especifica que uma propriedade não pode ser combinada com propriedades que pertencem a outros objetos em uma janela Propriedades. Esse campo static é somente leitura.
Yes	Especifica que uma propriedade pode ser combinada com propriedades que pertencem a outros objetos em uma janela Propriedades. Esse campo static é somente leitura.

Propriedades

AllowMerge	Obtém um valor que indica se essa propriedade pode ser combinada às propriedades que pertencem a outros objetos em uma janela Propriedades.
TypeId	Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute)

Métodos

Equals(Object)	Indica se essa instância e um objeto especificado são iguais.
GetHashCode()	Retorna o código hash para a instância.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsDefaultAttribute()	Determina se este atributo é o padrão.
Match(Object)	Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• PropertyDescriptor
• AttributeCollection
• PropertyDescriptorCollection
• Attribute