BindableObjectExtensions.SetBinding Método

Definição

Sobrecargas

SetBinding(BindableObject, BindableProperty, String, BindingMode, IValueConverter, String)

Cria e aplica uma associação a uma propriedade.Creates and applies a binding to a property.

SetBinding<TSource>(BindableObject, BindableProperty, Expression<Func<TSource,Object>>, BindingMode, IValueConverter, String)
Obsoleto.

Cria e aplica uma associação de uma expressão.Creates and applies a binding from an expression.

SetBinding(BindableObject, BindableProperty, String, BindingMode, IValueConverter, String)

Cria e aplica uma associação a uma propriedade.Creates and applies a binding to a property.

public static void SetBinding (this Xamarin.Forms.BindableObject self, Xamarin.Forms.BindableProperty targetProperty, string path, Xamarin.Forms.BindingMode mode = Xamarin.Forms.BindingMode.Default, Xamarin.Forms.IValueConverter converter = default, string stringFormat = default);
static member SetBinding : Xamarin.Forms.BindableObject * Xamarin.Forms.BindableProperty * string * Xamarin.Forms.BindingMode * Xamarin.Forms.IValueConverter * string -> unit

Parâmetros

targetProperty
BindableProperty

A BindableProperty na qual definir uma associação.The BindableProperty on which to set a binding.

path
String

Uma String que indica o caminho da propriedade à qual associar.A String indicating the property path to bind to.

mode
BindingMode

O BindingMode para a associação.The BindingMode for the binding. Esse parâmetro é opcional.This parameter is optional. O padrão é Default.Default is Default.

converter
IValueConverter

Um IValueConverter para a associação.An IValueConverter for the binding. Esse parâmetro é opcional.This parameter is optional. O padrão é null.Default is null.

stringFormat
String

Uma cadeia de caracteres usada como stringFormat para a associação.A string used as stringFormat for the binding. Esse parâmetro é opcional.This parameter is optional. O padrão é null.Default is null.

Comentários

O exemplo a seguir mostra como usar o método de extensão para definir uma associação.The following example shows how to use the extension method to set a binding.

public class PersonViewModel
{
    public string Name { get; set; }
    public string Company { get; set; }
}

// ...

var vm = new PersonViewModel {
    Name = "John Doe", 
    Company = "Xamarin"
}

var label = new Label ();
label.SetBinding (Label.TextProperty, "Name"); // "Name" is the property on the view model
label.BindingContext = vm;

Debug.WriteLine (label.Text); // prints "John Doe"

Aplica-se a

SetBinding<TSource>(BindableObject, BindableProperty, Expression<Func<TSource,Object>>, BindingMode, IValueConverter, String)

Cuidado

Esta API agora é obsoleta.

Cria e aplica uma associação de uma expressão.Creates and applies a binding from an expression.

[System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)]
[System.Obsolete]
public static void SetBinding<TSource> (this Xamarin.Forms.BindableObject self, Xamarin.Forms.BindableProperty targetProperty, System.Linq.Expressions.Expression<Func<TSource,object>> sourceProperty, Xamarin.Forms.BindingMode mode = Xamarin.Forms.BindingMode.Default, Xamarin.Forms.IValueConverter converter = default, string stringFormat = default);
static member SetBinding : Xamarin.Forms.BindableObject * Xamarin.Forms.BindableProperty * System.Linq.Expressions.Expression<Func<'Source, obj>> * Xamarin.Forms.BindingMode * Xamarin.Forms.IValueConverter * string -> unit

Parâmetros de tipo

TSource

O tipo de origem.The source type.

Parâmetros

self
BindableObject

O BindableObject.The BindableObject.

targetProperty
BindableProperty

A BindableProperty à qual associarThe BindableProperty to bind to

sourceProperty
Expression<Func<TSource,Object>>

Uma expressão usada para recuperar o caminho de origem.An expression used to retrieve the source path.

mode
BindingMode

O BindingMode para a associação.The BindingMode for the binding. Esse parâmetro é opcional.This parameter is optional. O padrão é Default.Default is Default.

converter
IValueConverter

Um IValueConverter para a associação.An IValueConverter for the binding. Esse parâmetro é opcional.This parameter is optional. O padrão é null.Default is null.

stringFormat
String

Uma cadeia de caracteres usada como stringFormat para a associação.A string used as stringFormat for the binding. Esse parâmetro é opcional.This parameter is optional. O padrão é null.Default is null.

Atributos

Comentários

Esse método de extensão usa Expression em vez de Path para cria e define associações.This extension method uses Expression instead of path to creates and sets bindings. O uso de expressões é mais amigável para refatoração.Using Expressions is more refactoring friendly.

Este exemplo a seguir ilustra a configuração de uma associação usando o método de extensão.This following example illustrates the setting of a binding using the extension method.

public class PersonViewModel
{
    public string Name { get; set; }
    public string Company { get; set; }
}

// ...

var vm = new PersonViewModel {
    Name = "John Doe", 
    Company = "Xamarin"
};

var label = new Label ();
label.SetBinding<PersonViewModel> (Label.TextProperty, vm => vm.Name);  // "Name" is the property on the view model
label.BindingContext = vm;

Debug.WriteLine (label.Text); // prints "John Doe"

Aplica-se a