Avalonia如何将样式应用到所有同类型控件 Avalonia全局Style

来源：这里教程网时间：2026-02-21 17:40:10 作者：

在Avalonia中，要将样式应用到所有同类型控件（例如所有

Button

），只需在应用级资源（

App.xaml

）或窗口/用户控件的

Resources

中定义一个**不带

x:Key

的Style**，并设置

TargetType

为对应控件类型即可。Avalonia会自动将其作为该类型的默认样式，应用于所有未显式指定

Style

的实例。

在App.xaml中定义全局默认Style

这是最常用、最推荐的方式，确保整个应用统一外观：

打开
App.xaml
（通常位于项目根目录）在
<application.resources></application.resources>
内添加Style，省略
x:Key
属性必须指定
TargetType
（如
Button
、
TextBox
等，支持完整类名或简写，推荐用简写+
xmlns
映射）

示例（App.xaml）：

<Application xmlns="https://github.com/avaloniaui">
  <Application.Resources>
    <Style TargetType="Button">
      <Setter Property="Background" Value="#007acc"/>
      <Setter Property="Foreground" Value="White"/>
      <Setter Property="Padding" Value="12 6"/>
    </Style>
    <Style TargetType="TextBox">
      <Setter Property="BorderBrush" Value="#cccccc"/>
      <Setter Property="Background" Value="White"/>
    </Style>
  </Application.Resources>
</Application>

作用范围与继承规则

全局Style默认作用于整个

Application

生命周期：

所有未设置
Style
属性的
Button
都会自动使用该Style 若某处显式设置了
Style="{StaticResource MyButtonStyle}"
，则优先使用该显式引用的Style 若设置了
Style="{Null}"
，则完全跳过默认Style（回归控件默认模板） 子窗口/用户控件无需重复声明，自动继承App级资源

基于BaseStyle扩展或覆盖

如需保留部分默认行为并仅修改特定属性，可基于Avalonia内置Style扩展：

使用
BasedOn
引用系统默认Style（需先获取其Key，常见为
{x:Type Button}
） 更稳妥的做法是：复制Avalonia源码中的默认Style片段，再按需调整 也可在同一个
Resources
中定义多个同
TargetType
的Style，但只有第一个（无
x:Key
）生效；后续有
x:Key
的可用于手动复用

示例（扩展默认Button样式）：

<Style TargetType="Button" BasedOn="{StaticResource {x:Type Button}}">
  <Setter Property="FontSize" Value="14"/>
  <Setter Property="FontWeight" Value="Bold"/>
</Style>

调试与验证技巧

如果样式未生效，可快速排查：

确认
TargetType
拼写正确（区分大小写，且必须与控件实际类型完全一致）检查是否在控件上误加了
Style="{x:Null}"
或显式引用了其他Style 使用
DeveloperTools
（启用
AppBuilder.UseDeveloperTools()
）在运行时查看元素的实际Style来源确保
App.xaml
被正确加载（检查
Program.cs
中
AppBuilder
是否调用了
.UsePlatformDetect().SetupWithLifetime(...)
）