Partilhar via


Binding.Mode Propriedade

Definição

Obtém ou define um valor que indica a direção do fluxo de dados na associação.

public:
 property BindingMode Mode { BindingMode get(); void set(BindingMode value); };
BindingMode Mode();

void Mode(BindingMode value);
public BindingMode Mode { get; set; }
var bindingMode = binding.mode;
binding.mode = bindingMode;
Public Property Mode As BindingMode
<Binding Mode="bindingModeMemberName"/>

Valor da propriedade

Um dos valores BindingMode . O padrão é OneWay: a origem atualiza o destino, mas as alterações no valor de destino não atualizam a origem.

Exemplos

Este exemplo demonstra como definir o modo de associação em XAML.

<TextBox x:Name="MyTextBox" Text="Text" Foreground="{Binding Brush1, Mode=OneWay}"/>

Comentários

Para associações OneWay e TwoWay , as alterações dinâmicas na origem não se propagam automaticamente para o destino sem fornecer algum suporte da origem. Você deve implementar a interface INotifyPropertyChanged no objeto de origem para que a origem possa relatar alterações por meio de eventos que o mecanismo de associação escuta. Para C# ou Microsoft Visual Basic, implemente System.ComponentModel.INotifyPropertyChanged. Para extensões de componente do Visual C++ (C++/CX), implemente Windows::UI::Xaml::D ata::INotifyPropertyChanged.

Para associações TwoWay , as alterações no destino são propagadas automaticamente para a origem, exceto se o destino de associação for a propriedade TextBox.Text . Nesse caso, a atualização ocorre somente quando o TextBox perde o foco. Além disso, é possível definir UpdateSourceTrigger em associações TwoWay como Explicit, nesse caso, você controla as atualizações para a origem explicitamente chamando UpdateSource.

Para associações OneTime e OneWay , as chamadas para DependencyObject.SetValue alteram automaticamente o valor de destino e excluem a associação.

Não é possível definir os valores de propriedade de um objeto Binding depois que essa associação tiver sido anexada a um elemento de destino e à propriedade de destino. Se você tentar isso, obterá uma exceção em tempo de execução.

Aplica-se a

Confira também