MergablePropertyAttribute Klasse

Definition

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.Primitives.dll

Quelle:

MergablePropertyAttribute.cs

Gibt an, dass diese Eigenschaft in einem Eigenschaftenfenster mit Eigenschaften von anderen Objekten kombiniert werden kann.

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

Vererbung

Object

Attribute

MergablePropertyAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Beispiel wird eine Eigenschaft als zum Zusammenführen geeignet markiert.

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

Das nächste Beispiel zeigt, wie der Wert von MergablePropertyAttribute für MyPropertyüberprüft wird. Zunächst ruft der Code eine PropertyDescriptorCollection mit allen Eigenschaften für das -Objekt ab. Als Nächstes indiziert es in den PropertyDescriptorCollection , um abzurufen MyProperty. Anschließend werden die Attribute für diese Eigenschaft zurückgegeben und in der Variablen attribute gespeichert.

Das Beispiel zeigt zwei verschiedene Möglichkeiten zum Überprüfen des Werts von MergablePropertyAttribute. Im zweiten Codefragment ruft das Beispiel die Equals -Methode mit einem Wert auf static . Im letzten Codefragment wird im Beispiel die AllowMerge -Eigenschaft verwendet, um den Wert zu überprüfen.

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

Wenn Sie eine Klasse mit MergablePropertyAttributemarkiert haben, verwenden Sie den folgenden Code, um den Wert zu überprüfen.

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

Hinweise

Eigenschaften, die mit dem Satz auf true gekennzeichnet sind, können mit Eigenschaften kombiniert werden, die MergablePropertyAttribute zu anderen Objekten in einer Eigenschaftenfenster gehören. Eigenschaften, die mit dem MergablePropertyAttribute Set auf gekennzeichnet sind, false müssen separat angezeigt werden. Der Standardwert lautet true.

Hinweis

Wenn Sie eine Eigenschaft mit dem MergablePropertyAttribute Wert auf truemarkieren, wird der Wert dieses Attributs auf das konstante Element Yesfestgelegt. Für eine Eigenschaft, die mit festgelegter MergablePropertyAttribute Eigenschaft gekennzeichnet falseist, ist Noder Wert . Wenn Sie daher den Wert dieses Attributs in Ihrem Code überprüfen möchten, müssen Sie das Attribut als MergablePropertyAttribute.Yes oder MergablePropertyAttribute.Noangeben.

Weitere Informationen finden Sie unter Attribute.

Konstruktoren

MergablePropertyAttribute(Boolean)

Initialisiert eine neue Instanz der MergablePropertyAttribute-Klasse.

Felder

Default	Gibt den Standardwert an, der Yes ist, d. h., eine Eigenschaft kann mit Eigenschaften kombiniert werden, die zu anderen Objekten in einem Eigenschaftenfenster gehören. Dieses static-Feld ist schreibgeschützt.
No	Gibt an, dass eine Eigenschaft in einem Eigenschaftenfenster nicht mit Eigenschaften von anderen Objekten kombiniert werden kann. Dieses static-Feld ist schreibgeschützt.
Yes	Gibt an, dass eine Eigenschaft in einem Eigenschaftenfenster mit Eigenschaften von anderen Objekten kombiniert werden kann. Dieses static-Feld ist schreibgeschützt.

Eigenschaften

AllowMerge	Ruft einen Wert ab, der angibt, ob diese Eigenschaft in einem Eigenschaftenfenster mit Eigenschaften von anderen Objekten kombiniert werden kann.
TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)

Methoden

Equals(Object)	Gibt an, ob diese Instanz und ein angegebenes Objekt gleich sind.
GetHashCode()	Gibt den Hashcode für diese Instanz zurück.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Bestimmt, ob dieses Attribut der Standardwert ist.
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• PropertyDescriptor
• AttributeCollection
• PropertyDescriptorCollection
• Attribute