Avalonia 支持在运行时动态创建控件,无需 XAML,纯 C# 即可构建 UI。核心是直接 new 控件、设置属性、添加到父容器(如
Panel、
StackPanel、
Grid等),再通过
Children.Add()或
Children.Insert()加入可视化树。
基础动态创建示例
比如在窗口中动态添加一个按钮:
var button = new Button
{
Content = "点我",
Margin = new Thickness(10)
};
// 假设 this.Content 是一个 Panel(如 StackPanel)
if (this.Content is Panel panel)
{
panel.Children.Add(button);
}
注意:必须确保父容器是支持子元素的面板类型(
Panel及其子类),且已挂载到可视树中(通常在
OnAttachedToVisualTree后操作更安全)。
动态绑定命令与事件
按钮点击逻辑可通过
Command或
Click事件实现: 用命令(推荐,符合 MVVM):
button.Command = new RelayCommand(() => Console.WriteLine("已点击"));
用事件:button.Click += (s, e) => MessageBox.Show("Hello!");
若使用 ViewModel 绑定,确保
DataContext已设置,且命令属性为 public。
动态构建复杂布局(如 Grid + 行列)
Grid 需手动定义行/列,并用附加属性指定子控件位置:
var grid = new Grid();
grid.RowDefinitions = new RowDefinitions("Auto, *");
grid.ColumnDefinitions = new ColumnDefinitions("Auto, *");
<p>var label = new TextBlock { Text = "用户名:" };
Grid.SetRow(label, 0); Grid.SetColumn(label, 0);</p><p>var tb = new TextBox();
Grid.SetRow(tb, 0); Grid.SetColumn(tb, 1);</p><p>grid.Children.Add(label);
grid.Children.Add(tb);
关键点:
Grid.SetRow/Column是静态方法,必须调用才能生效;行列定义顺序影响布局,
*表示自适应剩余空间。
动态替换或更新已有 UI
常见需求如切换内容区域:
清空旧内容:panel.Children.Clear();替换整个内容:
this.Content = new StackPanel { Children = { new TextBlock { Text = "新界面" } } };
局部更新:保存对某控件的引用,后续修改其 Content、
Visibility或重新赋值
Children。
注意:Avalonia 的 UI 是线程敏感的,所有控件操作必须在 UI 线程执行。跨线程需用
Dispatcher.UIThread.InvokeAsync(() => { /* 创建控件 */ });。
基本上就这些 —— 动态创建不复杂,但容易忽略父容器类型、附加属性设置和线程上下文。只要记住“new → 设属性 → 设附加属性(如 Grid)→ Add 到 Panel”,就能稳稳跑起来。
