绑定

你可以使用{Binding}标记拓展在XAML中进行绑定。通过绑定,所有数据上下文(假设你已经为其实现了变化通知)的变化都将自动更新到控件上。

绑定默认是DataContext的属性。例如:

<!-- 绑定 TextBlock 的 DataContext.Name 属性 -->
<TextBlock Text="{Binding Name}"/>

<!-- 如下等同 ('Path' 是可选的) -->
<TextBlock Text="{Binding Path=Name}"/>

空白的绑定是绑定在DataContext本身

<!-- 绑定至 TextBlock 的 DataContext 属性 -->
<TextBlock Text="{Binding}"/>

<!-- 等同如下 -->
<TextBlock Text="{Binding .}"/>

我们将控件的属性称为绑定的 目标,而DataContext的属性称为绑定的

绑定路径

绑定的路径可以是一个属性,也可以是连续调用的一串属性。例如,如果DataContext所赋值有Student属性,而这个属性的值有Name属性,那么你可以用如下方法绑定学生的名字:

<TextBlock Text="{Binding Student.Name}"/>

你还可以在绑定路径中使用列表或数组的索引器

<TextBlock Text="{Binding Students[0].Name}"/>

绑定模式

你可以通过指定{Binding}Mode来修改绑定的行为:

<TextBlock Text="{Binding Name, Mode=OneTime}">

可用的绑定模式包括:

模式
详情

OneWay

源的变化自动传播到目标

TwoWay

源和目标的变化互相传播

OneTime

源的初始值会应用到目标,但后续的变化会被无视

OneWayToSource

目标的变化自动传播到源

Default

依据属性而定

如果没有设定模式,则默认为Default模式。通常情况下如果控件属性不需要相应用户输入则是OneWay(例如TextBlock.Text);如果需要依用户输入而变则是TwoWay(例如TextBox.Text)。

格式字符串

你可以为绑定设置格式字符串,从而影响在UI上如何展现值:

<!-- 选项 1: 使用花括号对格式字符串进行转义 -->
<TextBlock Text="{Binding FloatValue, StringFormat={}{0:0.0}}" />

<!-- 选项 2: 使用反斜线对格式字符串进行转义 -->
<TextBlock Text="{Binding FloatValue, StringFormat=\{0:0.0\}}" />

<!-- 选项 3: 如果格式字符串并非以{0}开始,则不需要转义 -->
<!-- 注意:如果在格式字符串中存在空格,则需要用单引号''包裹起来 -->
<TextBlock Text="{Binding Animals.Count, StringFormat='I have {0} animals.'}" />
<!-- 注意: 如果格式字符串以{0}开始则需要转义,例如:-->
<TextBlock Text="{Binding Animals.Count, StringFormat='{}{0} animals live in the farm.'}" />

StringFormat属性存在时,绑定的值将会由StringFormatValueConverter利用指定的格式字符串进行转换。

与WPF不同,你需要将格式字符串用花括号包裹起来并以0:开始({0:TheStringFormat})。如果格式字符串中花括号出现在开始,那么即使用单引号包裹起来,也需要进行转义。可以在前面加{},也可以使用反斜线\{...\}

WPF:

<TextBlock Text="{Binding FloatValue, StringFormat=0.0}" />

Avalonia:

<TextBlock Text="{Binding FloatValue, StringFormat={}{0:0.0}}" />
<TextBlock Text="{Binding FloatValue, StringFormat=\{0:0.0\}}" />
<TextBlock Text="{Binding FloatValue, StringFormat='{}{0:0.0}'}" />

格式字符串详情请阅读微软文档

范例

Basic MVVM Sample

最后更新于