BindableAttribute Klasse

Definition

Gibt an, ob ein Member normalerweise für Bindungen verwendet wird.Specifies whether a member is typically used for binding. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class BindableAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.All)]
public sealed class BindableAttribute : Attribute
type BindableAttribute = class
    inherit Attribute
Public NotInheritable Class BindableAttribute
Inherits Attribute
Vererbung
BindableAttribute
Attribute

Beispiele

Im folgenden Codebeispiel wird eine-Eigenschaft entsprechend gekennzeichnet, um Daten an zu binden.The following code example marks a property as appropriate to bind data to.

property int MyProperty 
{
   [System::ComponentModel::Bindable(true)]
   int get()
   {
      // Insert code here.
      return 0;
   }

   [System::ComponentModel::Bindable(true)]
   void set( int )
   {
      // Insert code here.
   }
}
[Bindable(true)]
 public int MyProperty {
    get {
       // Insert code here.
       return 0;
    }
    set {
       // Insert code here.
    }
 }
<Bindable(True)> _
Public Property MyProperty() As Integer
    Get
        ' Insert code here.
        Return 0
    End Get
    Set
         ' Insert code here.
    End Set
End Property

Im nächsten Codebeispiel wird gezeigt, wie der Wert von BindableAttribute für MyPropertyüberprüft wird.The next code example shows how to check the value of the BindableAttribute for MyProperty. Zuerst ruft der Code ein PropertyDescriptorCollection -Objekt mit allen Eigenschaften für das-Objekt ab.First, the code gets a PropertyDescriptorCollection with all the properties for the object. Im nächsten Schritt wird der Code in PropertyDescriptorCollection die MyProperty-Datei indiziert.Next, the code indexes into the PropertyDescriptorCollection to get MyProperty. Schließlich gibt der Code die Attribute für diese Eigenschaft zurück und speichert Sie in der Attribute-Variablen.Finally, the code returns the attributes for this property and saves them in the attributes variable. Das Codebeispiel zeigt zwei verschiedene Möglichkeiten, den Wert von BindableAttributezu überprüfen.The code example presents two different ways to check the value of the BindableAttribute. Im zweiten Code Fragment Ruft das Beispiel die Equals -Methode auf.In the second code fragment, the example calls the Equals method. Im letzten Code Fragment verwendet Bindable das Beispiel die-Eigenschaft, um den Wert zu überprüfen.In the last code fragment, the example uses the Bindable property to check the value.

using namespace System::ComponentModel;

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

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

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

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

// Yet another way to see whether the property is bindable.
if (attributes.Contains(BindableAttribute.Yes)) {
   // 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 BindableAttribute is Yes.
    If attributes(GetType(BindableAttribute)).Equals(BindableAttribute.Yes) Then
        ' Insert code here.
    End If 
    
    ' This is another way to see whether the property is bindable.
    Dim myAttribute As BindableAttribute = _
        CType(attributes(GetType(BindableAttribute)), BindableAttribute)
    If myAttribute.Bindable Then
        ' Insert code here.
    End If 

' Yet another way to see whether the property is bindable.
If attributes.Contains(BindableAttribute.Yes) Then
' Insert code here.
End If

Wenn Sie eine Klasse mit dem BindableAttributegekennzeichnet haben, verwenden Sie das folgende Codebeispiel, um den Wert zu überprüfen.If you marked a class with the BindableAttribute, use the following code example to check the value.

using namespace System::ComponentModel;
AttributeCollection^ attributes = TypeDescriptor::GetAttributes( MyProperty );
if ( attributes[ BindableAttribute::typeid ]->Equals( BindableAttribute::Yes ) )
{
   // Insert code here.
}
AttributeCollection attributes = 
    TypeDescriptor.GetAttributes(MyProperty);
 if(attributes[typeof(BindableAttribute)].Equals(BindableAttribute.Yes)) {
    // Insert code here.
 }
Dim attributes As AttributeCollection = TypeDescriptor.GetAttributes(MyProperty)
If attributes(GetType(BindableAttribute)).Equals(BindableAttribute.Yes) Then
    ' Insert code here.
End If 

Hinweise

Sie können dieses Attribut für mehrere Elemente, in der Regel Eigenschaften, auf einem Steuerelement angeben.You can specify this attribute for multiple members, typically properties, on a control.

Wenn eine Eigenschaft mit der BindableAttribute auf truefestgelegten festgelegt wurde, sollte für diese Eigenschaft eine Benachrichtigung über eine Eigenschafts Änderung ausgelöst werden.If a property has been marked with the BindableAttribute set to true, then a property change notification should be raised for that property. Dies bedeutet, dass die Bindable bidirektionale Datenbindung unterstützt wird, wenn die-Eigenschaft ist. YesThis means that if the Bindable property is Yes, then two-way data binding is supported. Wenn Bindable istNo, können Sie weiterhin eine Bindung an die-Eigenschaft herstellen, Sie sollte jedoch nicht im Standardsatz von Eigenschaften angezeigt werden, an die die Bindung erfolgen soll, da Sie möglicherweise eine Benachrichtigung über eine Eigenschafts Änderung aufhebt.If Bindable is No, you can still bind to the property, but it should not be shown in the default set of properties to bind to, because it might or might not raise a property change notification.

Hinweis

Wenn Sie eine Eigenschaft mit BindableAttribute dem Wert auf truefestlegen, wird der Wert dieses Attributs auf den konstanten Member Yesfestgelegt.When you mark a property with BindableAttribute set to true, the value of this attribute is set to the constant member Yes. Für eine Eigenschaft, die mit BindableAttribute dem auf falsefestgelegt ist, Noist der Wert.For a property marked with the BindableAttribute set to false, the value is No. Um den Wert dieses Attributs im Code zu überprüfen, müssen Sie daher das-Attribut als BindableAttribute.Yes oder BindableAttribute.Noangeben.Therefore, to check the value of this attribute in your code, you must specify the attribute as BindableAttribute.Yes or BindableAttribute.No.

Achtung

Dieses Attribut kann nur zur Entwurfszeit verwendet werden.You can use this attribute at design time only. Nichts hindert Sie daran, während der Laufzeit an eine beliebige Eigenschaft zu binden.Nothing prevents you from binding to any property during run time.

Weitere Informationen finden Sie unter Attribute.For more information, see Attributes.

Konstruktoren

BindableAttribute(BindableSupport)

Initialisiert eine neue Instanz der BindableAttribute-Klasse mit einem der BindableSupport-Werte.Initializes a new instance of the BindableAttribute class with one of the BindableSupport values.

BindableAttribute(BindableSupport, BindingDirection)

Initialisiert eine neue Instanz der BindableAttribute-Klasse.Initializes a new instance of the BindableAttribute class.

BindableAttribute(Boolean)

Initialisiert eine neue Instanz der BindableAttribute-Klasse mit einem booleschen Wert.Initializes a new instance of the BindableAttribute class with a Boolean value.

BindableAttribute(Boolean, BindingDirection)

Initialisiert eine neue Instanz der BindableAttribute-Klasse.Initializes a new instance of the BindableAttribute class.

Felder

Default

Gibt den Standardwert für das BindableAttribute an, der No ist.Specifies the default value for the BindableAttribute, which is No. Dieses Feld ist schreibgeschützt.This field is read-only.

No

Gibt an, dass eine Eigenschaft normalerweise nicht für Bindungen verwendet wird.Specifies that a property is not typically used for binding. Dieses Feld ist schreibgeschützt.This field is read-only.

Yes

Gibt an, dass eine Eigenschaft normalerweise für Bindungen verwendet wird.Specifies that a property is typically used for binding. Dieses Feld ist schreibgeschützt.This field is read-only.

Eigenschaften

Bindable

Ruft einen Wert ab, der angibt, dass eine Eigenschaft normalerweise für Bindungen verwendet wird.Gets a value indicating that a property is typically used for binding.

Direction

Ruft einen Wert ab, der die Richtung bzw. Richtungen der Datenbindung dieser Eigenschaft angibt.Gets a value indicating the direction or directions of this property's data binding.

TypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab.When implemented in a derived class, gets a unique identifier for this Attribute.

(Geerbt von Attribute)

Methoden

Equals(Object)

Bestimmt, ob zwei BindableAttribute-Objekte gleich sind.Determines whether two BindableAttribute objects are equal.

GetHashCode()

Fungiert als eine Hashfunktion für die BindableAttribute-Klasse.Serves as a hash function for the BindableAttribute class.

GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
IsDefaultAttribute()

Bestimmt, ob dieses Attribut der Standardwert ist.Determines if this attribute is the default.

Match(Object)

Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Geerbt von Attribute)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

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

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.Maps a set of names to a corresponding set of dispatch identifiers.

(Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit.Provides access to properties and methods exposed by an object.

(Geerbt von Attribute)

Gilt für:

Siehe auch