BindableAttribute BindableAttribute BindableAttribute BindableAttribute Class

Definición

Especifica si un miembro se usa normalmente para el enlace. Specifies whether a member is typically used for binding. Esta clase no puede heredarse. 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
Herencia
BindableAttributeBindableAttributeBindableAttributeBindableAttribute
Atributos

Ejemplos

En el ejemplo de código siguiente se marca una propiedad según corresponda enlazar datos.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

El ejemplo de código siguiente muestra cómo comprobar el valor de la BindableAttribute para MyProperty.The next code example shows how to check the value of the BindableAttribute for MyProperty. En primer lugar, el código obtiene una PropertyDescriptorCollection con todas las propiedades del objeto.First, the code gets a PropertyDescriptorCollection with all the properties for the object. A continuación, el código se indiza en la PropertyDescriptorCollection obtener MyProperty.Next, the code indexes into the PropertyDescriptorCollection to get MyProperty. Por último, el código devuelve los atributos de esta propiedad y los guarda en la variable de atributos.Finally, the code returns the attributes for this property and saves them in the attributes variable. El ejemplo de código muestra dos formas diferentes para comprobar el valor de la BindableAttribute.The code example presents two different ways to check the value of the BindableAttribute. En el segundo fragmento de código, se llama el Equals método.In the second code fragment, the example calls the Equals method. En el último fragmento de código, el ejemplo se usa el Bindable propiedad para comprobar el valor.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

Si marca una clase con el BindableAttribute, utilice el siguiente ejemplo de código para comprobar el valor.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 

Comentarios

Puede especificar este atributo para varios miembros, normalmente propiedades, en un control.You can specify this attribute for multiple members, typically properties, on a control.

Si una propiedad se ha marcado con el BindableAttribute establecido en true, a continuación, debe emitirse una notificación de cambio de propiedad para esa propiedad.If a property has been marked with the BindableAttribute set to true, then a property change notification should be raised for that property. Esto significa que si el Bindable propiedad es Yes, a continuación, se admite el enlace de datos bidireccional.This means that if the Bindable property is Yes, then two-way data binding is supported. Si Bindable es No, también puede enlazar a la propiedad, pero no se debe mostrar en el conjunto predeterminado de propiedades desea enlazar, ya que puede o no es posible que genere una notificación de cambio de propiedad.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.

Nota

Cuando se marca una propiedad con BindableAttribute establecido en true, el valor de este atributo se establece en el miembro constante Yes.When you mark a property with BindableAttribute set to true, the value of this attribute is set to the constant member Yes. Para una propiedad marcada con el BindableAttribute establecido en false, el valor es No.For a property marked with the BindableAttribute set to false, the value is No. Por lo tanto, para comprobar el valor de este atributo en el código, debe especificar el atributo como BindableAttribute.Yes o BindableAttribute.No.Therefore, to check the value of this attribute in your code, you must specify the attribute as BindableAttribute.Yes or BindableAttribute.No.

Precaución

Puede usar este atributo en tiempo de diseño únicamente.You can use this attribute at design time only. Nada le impide enlace a cualquier propiedad de tiempo de ejecución.Nothing prevents you from binding to any property during run time.

Para obtener más información, consulte Attributes (Atributos).For more information, see Attributes.

Constructores

BindableAttribute(BindableSupport) BindableAttribute(BindableSupport) BindableAttribute(BindableSupport) BindableAttribute(BindableSupport)

Inicializa una nueva instancia de la clase BindableAttribute con uno de los valores de BindableSupport. Initializes a new instance of the BindableAttribute class with one of the BindableSupport values.

BindableAttribute(BindableSupport, BindingDirection) BindableAttribute(BindableSupport, BindingDirection) BindableAttribute(BindableSupport, BindingDirection) BindableAttribute(BindableSupport, BindingDirection)

Inicializa una nueva instancia de la clase BindableAttribute. Initializes a new instance of the BindableAttribute class.

BindableAttribute(Boolean) BindableAttribute(Boolean) BindableAttribute(Boolean) BindableAttribute(Boolean)

Inicializa una nueva instancia de la clase BindableAttribute con un valor booleano. Initializes a new instance of the BindableAttribute class with a Boolean value.

BindableAttribute(Boolean, BindingDirection) BindableAttribute(Boolean, BindingDirection) BindableAttribute(Boolean, BindingDirection) BindableAttribute(Boolean, BindingDirection)

Inicializa una nueva instancia de la clase BindableAttribute. Initializes a new instance of the BindableAttribute class.

Campos

Default Default Default Default

Especifica el valor predeterminado de BindableAttribute, que es No. Specifies the default value for the BindableAttribute, which is No. Este campo es de solo lectura. This field is read-only.

No No No No

Especifica que una propiedad no se utiliza normalmente para el enlace. Specifies that a property is not typically used for binding. Este campo es de solo lectura. This field is read-only.

Yes Yes Yes Yes

Especifica que una propiedad se utiliza normalmente para el enlace. Specifies that a property is typically used for binding. Este campo es de solo lectura. This field is read-only.

Propiedades

Bindable Bindable Bindable Bindable

Obtiene un valor que indica que una propiedad se utiliza normalmente para el enlace. Gets a value indicating that a property is typically used for binding.

Direction Direction Direction Direction

Obtiene un valor que indica la dirección o direcciones del enlace de datos de esta propiedad. Gets a value indicating the direction or directions of this property's data binding.

TypeId TypeId TypeId TypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute. When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Métodos

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si los dos objetos BindableAttribute son iguales. Determines whether two BindableAttribute objects are equal.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como función hash para la clase BindableAttribute. Serves as a hash function for the BindableAttribute class.

GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual. Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

Determina si este atributo es el valor predeterminado. Determines if this attribute is the default.

Match(Object) Match(Object) Match(Object) Match(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado. When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del Object actual. Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual. Returns a string that represents the current object.

(Inherited from Object)

Implementaciones de interfaz explícitas

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

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío. Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz. Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1). Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acceso a las propiedades y los métodos expuestos por un objeto. Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Se aplica a

Consultar también