BindableObject Clase

Para enlazar los datos detrás de una propiedad en , BindableObjectnormalmente una vista, a una propiedad en el modelo de vista, los desarrolladores de aplicaciones deben hacer lo siguiente.

En primer lugar, el desarrollador crea un par de propiedades en la vista, una de las cuales es , BindablePropertyy la otra de las cuales es una propiedad de cualquier tipo que se requiera. En el código siguiente, MockBindableObject significa lo que normalmente sería un objeto de interfaz de usuario en el código de producción. Los desarrolladores de aplicaciones deben tener en cuenta el uso de SetValue(BindableProperty, Object) y GetValue(BindableProperty) para obtener y establecer el valor en la propiedad enlazada; La propiedad del tipo deseado proporciona la interfaz que implementará el destino de la propiedad enlazada.

class MockBindableObject : BindableObject
{
    // App developers should use the method below in production code for 
    // better performance
    public static readonly BindableProperty BoundNameProperty =
         BindableProperty.Create ("Foo", typeof (string),
                                  typeof (MockBindableObject),
                                  default(string));

    // App developers should use the method below during development for
    // design-time error checking as the codebase evolves.
    // public static readonly BindableProperty FooProperty 
    //     = BindableProperty.Create<MockBindableObject, string> (
    //         o => o.Foo, default (string)
    //     );

    public string BoundName
    {
        get { return (string) GetValue (BoundNameProperty); }
        set { SetValue (BoundNameProperty, value); }
    }
}

En segundo lugar, el desarrollador crea la implementación de la propiedad enlazada en una clase que implementa la System.ComponentModel.INotifyPropertyChanged interfaz . En el patrón de diseño de MVVM, normalmente lo hace el modelo de vista. Los desarrolladores de aplicaciones deben implementar la System.ComponentModel.INotifyPropertyChanged interfaz en las clases que quieren usar como modelos de vista. En el ejemplo siguiente, los desarrolladores de aplicaciones deben tomar nota de la forma idiomática en la que se implementa la Name propiedad, en primer lugar, asegurarse de que la propiedad ha cambiado y devuelto realmente si no lo hizo, y solo asignar el valor y llamar al OnPropertyChanged(String) método . Además, la Name propiedad del ejemplo siguiente simplemente ajusta el name campo. En la práctica, el desarrollador de aplicaciones puede elegir un modelo diferente en el que almacenar los datos de la aplicación.

class MockViewModel : INotifyPropertyChanged
{
    string name;

    public string Name
    {
        get { return name; }
        set
        {
            // OnPropertyChanged should not be called if the property value
            // does not change.
            if (name == value)
                return;
            name = value;
            OnPropertyChanged ();
        }
    }

    public event PropertyChangedEventHandler PropertyChanged;

    void OnPropertyChanged (string propertyName = null)
    {
        PropertyChangedEventHandler handler = PropertyChanged;
        if (handler != null)
            handler (this, new PropertyChangedEventArgs (propertyName));
    }
}

En tercer lugar, y por último, el desarrollador de aplicaciones enlaza una instancia de BindableObject a una instancia que implementa INotifyPropertyChanged. En el vocabulario del patrón de diseño de MVVM, se trata de "enlazar una instancia de la vista a una instancia de un modelo de vista". Una vez completado este paso, los cambios en los datos se propagan entre el modelo de vista y vista de una manera determinada por el valor de la BindingMode enumeración, si existe, que se pasó durante el paso de enlace.

El código siguiente, cuando se incluye en un proyecto que hace referencia a las clases anteriores, crea una instancia de MockBindable y MockViewModel, realiza alguna inicialización, establece el enlace y, a continuación, muestra un enlace unidireccional. El código siguiente se ejecuta sin producir una excepción.

public static void OneWayDemo ()
{
    var view = new MockBindableObject ();
    var viewModel = new MockViewModel ();

    // Pre-load the ViewModel, for demonstration purposes
    viewModel.Name = "Testing";

    // Create a one-way (default) binding
    view.SetBinding (MockBindableObject.BoundNameProperty, new Binding ("Name"));

    // App developers should only set the binding context after all
    // calls to SetBinding() have been made, for performance reasons.
    view.BindingContext = viewModel;

    // In a one way binding, the ViewModel value will be used to update
    // the values in the View during initialization
    if (view.BoundName != "Testing")
        throw new Exception ();

    view.BoundName = "gnitseT";

    // in a one way binding, changes to the View will NOT update the ViewModel
    if (viewModel.Name == "gnitseT")
        throw new Exception ();
}