MergablePropertyAttribute Classe

Définition

Espace de noms:

System.ComponentModel

Assemblys:

netstandard.dll, System.ComponentModel.Primitives.dll

Source:

MergablePropertyAttribute.cs

Spécifie que cette propriété peut être combinée avec des propriétés appartenant à d’autres objets dans une fenêtre Propriétés.

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

Héritage

Object

Attribute

MergablePropertyAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple suivant marque une propriété en fonction de la fusion.

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

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

L’exemple présente deux façons différentes de vérifier la valeur du MergablePropertyAttribute. Dans le deuxième fragment de code, l’exemple appelle la Equals méthode avec une static valeur. Dans le dernier fragment de code, l’exemple utilise la AllowMerge propriété pour vérifier la valeur.

// 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 vous avez marqué une classe avec le MergablePropertyAttributecode suivant, utilisez le code suivant pour vérifier la valeur.

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

Remarques

Les propriétés marquées avec l’ensemble MergablePropertyAttribute peuvent true être combinées avec des propriétés appartenant à d’autres objets dans une fenêtre Propriétés. Les propriétés marquées avec le MergablePropertyAttribute jeu à false afficher séparément. La valeur par défaut est true.

Note

Lorsque vous marquez une propriété avec la MergablePropertyAttributetruevaleur définie sur , la valeur de cet attribut est définie sur le membre Yesconstant . Pour une propriété marquée avec la MergablePropertyAttribute propriété définie falsesur , 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 MergablePropertyAttribute.Yes ou MergablePropertyAttribute.No.

Pour plus d’informations, consultez Attributs.

Constructeurs

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

Champs

Nom	Description
Default	Spécifie la valeur par défaut, c’est-à-dire Yesqu’une propriété peut être combinée avec des propriétés appartenant à d’autres objets dans une fenêtre Propriétés. Ce static champ est en lecture seule.
No	Spécifie qu’une propriété ne peut pas être combinée avec des propriétés appartenant à d’autres objets dans une fenêtre Propriétés. Ce static champ est en lecture seule.
Yes	Spécifie qu’une propriété peut être combinée avec des propriétés appartenant à d’autres objets dans une fenêtre Propriétés. Ce static champ est en lecture seule.

Propriétés

Nom	Description
AllowMerge	Obtient une valeur indiquant si cette propriété peut être combinée avec des propriétés appartenant à d’autres objets dans une fenêtre Propriétés.
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)	Indique si cette instance et un objet spécifié sont égaux.
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)

Voir aussi

• PropertyDescriptor
• AttributeCollection
• PropertyDescriptorCollection
• Attribute