BindingMode Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Descreve como os dados se propagam em uma associação.
public enum class BindingMode
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class BindingMode
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum BindingMode
Public Enum BindingMode
<object property="enumMemberName"/>
- Herança
-
BindingMode
- Atributos
Requisitos do Windows
Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Campos
OneTime | 2 | Atualizações a propriedade de destino quando a associação é criada. |
OneWay | 1 | Atualizações a propriedade de destino quando a associação é criada. As alterações no objeto de origem também podem se propagar para o destino. |
TwoWay | 3 | Atualizações o destino ou o objeto de origem quando for alterado. Quando a associação é criada, a propriedade de destino é atualizada da 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. Você deve implementar a interface INotifyPropertyChanged no objeto de origem para que isso aconteça.
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 Text . Nesse caso, a atualização ocorre somente quando o TextBox perde o foco.
Para associações OneTime e OneWay , as chamadas para DependencyObject.SetValue alteram automaticamente o valor de destino e excluem a associação.